iobroker.parcelapp 0.8.0 → 0.10.0

package/README.md

@@ -45,7 +45,7 @@ For details and how to disable it, see the [Sentry plugin documentation](https:/
 | Option                    | Description                                                                                                | Default |
 | ------------------------- | ---------------------------------------------------------------------------------------------------------- | ------- |
 | **API Key**               | Your parcel.app API key (get it at [web.parcelapp.net](https://web.parcelapp.net))                         | —       |
-| **Poll Interval**         | How often to fetch updates (minutes)                                                                       | 10      |
+| **Poll Interval**         | How often to fetch updates (minutes). parcel.app serves the list from a ~45–90 min server cache, so shorter intervals mostly reduce the delay until a refresh is noticed. | 10      |
 | **Auto-remove delivered** | Remove delivered packages from states automatically. When disabled, they stay until deleted in parcel.app. | Yes     |
 
 Status labels (`Delivered`, `In Transit`, …) and delivery estimates (`today`, `tomorrow`, `in X days`) are rendered in the ioBroker system language.
@@ -65,7 +65,7 @@ parcelapp.0.
     └── {packageId}.             — One device per package
         ├── carrier              — Carrier name (e.g. DHL Express)
         ├── status               — Status text (e.g. In Transit)
-        ├── statusCode           — Status code (0-8)
+        ├── statusCode           — Status code (0-8, -1 = unknown)
         ├── description          — Package description
         ├── trackingNumber       — Tracking number
         ├── extraInfo            — Extra information (postal code, email)
@@ -73,9 +73,19 @@ parcelapp.0.
         ├── deliveryEstimate     — Human-readable estimate (today, tomorrow)
         ├── lastEvent            — Latest tracking event
         ├── lastLocation         — Last known location
-        └── lastUpdated          — Last update timestamp
+        └── lastUpdated          — Timestamp of the last tracking-data change
 ```
 
+**Status codes** (`statusCode` — the primary datapoint for automations):
+
+| Code | Meaning         | Code | Meaning                 |
+| ---- | --------------- | ---- | ----------------------- |
+| 0    | Delivered       | 5    | Not Found               |
+| 1    | Frozen          | 6    | Delivery Attempt Failed |
+| 2    | In Transit      | 7    | Exception               |
+| 3    | Awaiting Pickup | 8    | Info Received           |
+| 4    | Out for Delivery | -1  | Unknown (unexpected API value — package stays visible) |
+
 ---
 
 ## Add Deliveries via Script
@@ -93,11 +103,12 @@ sendTo("parcelapp.0", "addDelivery", {
 });
 ```
 
-`tracking_number`, `carrier_code` and `description` are required; `language` and `send_push_confirmation` are optional. The delivery is added to your parcel.app account and a poll is triggered right away — but freshly added deliveries usually have no tracking data yet (see the note below).
+`tracking_number`, `carrier_code` and `description` are required; `language` and `send_push_confirmation` are optional. The delivery is added to your parcel.app account and a poll follows right away (at most one poll per minute) — but freshly added deliveries usually have no tracking data yet (see the note below).
 
 **Notes:**
 
 - **POST rate limit: 20 deliveries per day** — failed attempts (e.g. wrong `carrier_code`) also count against this limit.
+- **Each field may be at most 512 characters**, and the adapter accepts at most **20 addDelivery calls per minute** — beyond either limit the call returns `success: false` with an explanatory `error_message` instead of reaching parcel.app.
 - Fresh deliveries usually have no tracking events for **45–90 minutes** after they are added. That's a parcel.app-side delay, not an adapter issue.
 - **Deleting packages is only possible in the parcel.app app/web UI** — the API has no delete endpoint. With `autoRemoveDelivered` enabled, the adapter still drops delivered packages from ioBroker states automatically.
 
@@ -113,7 +124,7 @@ sendTo("parcelapp.0", "addDelivery", {
 
 ### No deliveries shown
 
-- The API returns cached data — new deliveries may take a few minutes to appear
+- The API returns cached data — new deliveries and fresh tracking events can take **45–90 minutes** to appear (parcel.app-side cache)
 - Check if you have active deliveries in the parcel.app
 
 ### Rate limit
@@ -129,12 +140,28 @@ sendTo("parcelapp.0", "addDelivery", {
     Placeholder for the next version (at the beginning of the line):
     ### **WORK IN PROGRESS**
 -->
+### 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.
+
+### 0.9.0 (2026-06-23) — stable
+
+- Fixed: tracked packages could disappear from the object tree after a temporary update error or an unexpected API response — a package is now kept until parcel.app actually stops returning it.
+- Changed: multi-day delivery windows now show the date on each side (e.g. `12-06 14:30 - 12-08 18:30`) instead of looking same-day; out-of-range or reversed dates no longer produce a misleading window.
+
 ### 0.8.0 (2026-06-19)
 
 - The delivery window is now also shown for carriers that report it only as a date/time range, not just when the API provides a Unix timestamp.
 - When adding a delivery via script, you can now set an optional tracking language and request a push confirmation.
 
-### 0.7.2 (2026-06-12)
+### 0.7.2 (2026-06-12) — stable
 
 - Much quieter state updates: a package's last-updated timestamp now only changes when its tracking data actually changed, and device entries are no longer rewritten on every poll
 - Adding a delivery with a malformed request now returns a clear error message instead of failing cryptically
@@ -143,16 +170,6 @@ sendTo("parcelapp.0", "addDelivery", {
 
 - Fixed a timezone edge case in delivery estimates: when the API reports only a calendar date, the estimate could be off by a day in time zones west of UTC — now stable everywhere.
 
-### 0.7.0 (2026-06-07)
-
-- Added optional Sentry error reporting: crashes are sent to the developer so issues get fixed faster. Active only with ioBroker diagnostics enabled; anonymous.
-
-### 0.6.0 (2026-05-31)
-
-- The summary delivery window now covers the full time range when several packages are expected the same day — previously an overlapping window could be cut short.
-- Packages reported with an unrecognized status are no longer mistaken for delivered and removed; they stay visible as "Unknown".
-- A delivery added via the admin button now appears immediately instead of only after the next polling cycle.
-
 [Older changelogs can be found there](CHANGELOG_OLD.md)
 
 ## Support

package/admin/i18n/de.json

@@ -3,8 +3,6 @@
   "apiKeyInfo": "Gib deinen parcel.app API-Schlüssel ein. Ein Premium-Abo wird benötigt. Den Schlüssel findest du unter web.parcelapp.net → API-Bereich.",
   "label_apiKey": "API-Schlüssel",
   "btn_checkConnection": "Verbindung testen",
-  "msg_connectionOk": "Verbindung erfolgreich!",
-  "msg_connectionFailed": "Verbindung fehlgeschlagen!",
   "header_polling": "Abfrage",
   "label_pollInterval": "Abfrageintervall (Minuten)",
   "tooltip_pollInterval": "Wie oft Lieferupdates abgefragt werden (5-60 Minuten, Standard: 10). Rate-Limit: 20 Anfragen/Stunde.",
@@ -36,5 +34,15 @@
   "estimateOverdue": "überfällig",
   "estimateToday": "heute",
   "estimateTomorrow": "morgen",
-  "estimateDays": "in %d Tagen"
+  "estimateDays": "in %s Tagen",
+  "status_0": "Zugestellt",
+  "status_1": "Eingefroren",
+  "status_2": "Unterwegs",
+  "status_3": "Abholung erwartet",
+  "status_4": "In Zustellung",
+  "status_5": "Nicht gefunden",
+  "status_6": "Zustellversuch gescheitert",
+  "status_7": "Ausnahme",
+  "status_8": "Registriert",
+  "packageName": "Paket %s"
 }

package/admin/i18n/en.json

@@ -3,8 +3,6 @@
   "apiKeyInfo": "Enter your parcel.app API key. A Premium subscription is required. Get your key at web.parcelapp.net → API panel.",
   "label_apiKey": "API Key",
   "btn_checkConnection": "Test Connection",
-  "msg_connectionOk": "Connection successful!",
-  "msg_connectionFailed": "Connection failed!",
   "header_polling": "Polling",
   "label_pollInterval": "Poll Interval (minutes)",
   "tooltip_pollInterval": "How often to fetch delivery updates (5-60 minutes, default: 10). Rate limit: 20 requests/hour.",
@@ -36,5 +34,15 @@
   "estimateOverdue": "overdue",
   "estimateToday": "today",
   "estimateTomorrow": "tomorrow",
-  "estimateDays": "in %d days"
+  "estimateDays": "in %s days",
+  "status_0": "Delivered",
+  "status_1": "Frozen",
+  "status_2": "In Transit",
+  "status_3": "Awaiting Pickup",
+  "status_4": "Out for Delivery",
+  "status_5": "Not Found",
+  "status_6": "Delivery Attempt Failed",
+  "status_7": "Exception",
+  "status_8": "Info Received",
+  "packageName": "Package %s"
 }

package/admin/i18n/es.json

@@ -3,8 +3,6 @@
   "apiKeyInfo": "Introduce tu clave API de parcel.app. Se requiere una suscripción Premium. Obtén tu clave en web.parcelapp.net → panel API.",
   "label_apiKey": "Clave API",
   "btn_checkConnection": "Probar conexión",
-  "msg_connectionOk": "¡Conexión exitosa!",
-  "msg_connectionFailed": "¡Error de conexión!",
   "header_polling": "Consulta",
   "label_pollInterval": "Intervalo de consulta (minutos)",
   "tooltip_pollInterval": "Con qué frecuencia obtener actualizaciones de entrega (5-60 minutos, predeterminado: 10). Límite: 20 solicitudes/hora.",
@@ -36,5 +34,15 @@
   "estimateOverdue": "atrasado",
   "estimateToday": "hoy",
   "estimateTomorrow": "mañana",
-  "estimateDays": "en %d días"
+  "estimateDays": "en %s días",
+  "status_0": "Entregado",
+  "status_1": "Congelado",
+  "status_2": "En tránsito",
+  "status_3": "Esperando recogida",
+  "status_4": "En reparto",
+  "status_5": "No encontrado",
+  "status_6": "Intento de entrega fallido",
+  "status_7": "Excepción",
+  "status_8": "Registrado",
+  "packageName": "Paquete %s"
 }

package/admin/i18n/fr.json

@@ -3,8 +3,6 @@
   "apiKeyInfo": "Entrez votre clé API parcel.app. Un abonnement Premium est requis. Obtenez votre clé sur web.parcelapp.net → panneau API.",
   "label_apiKey": "Clé API",
   "btn_checkConnection": "Tester la connexion",
-  "msg_connectionOk": "Connexion réussie !",
-  "msg_connectionFailed": "Échec de la connexion !",
   "header_polling": "Interrogation",
   "label_pollInterval": "Intervalle d interrogation (minutes)",
   "tooltip_pollInterval": "Fréquence de récupération des mises à jour de livraison (5-60 minutes, défaut : 10). Limite : 20 requêtes/heure.",
@@ -36,5 +34,15 @@
   "estimateOverdue": "en retard",
   "estimateToday": "aujourd'hui",
   "estimateTomorrow": "demain",
-  "estimateDays": "dans %d jours"
+  "estimateDays": "dans %s jours",
+  "status_0": "Livré",
+  "status_1": "Gelé",
+  "status_2": "En transit",
+  "status_3": "En attente de retrait",
+  "status_4": "En cours de livraison",
+  "status_5": "Introuvable",
+  "status_6": "Échec de la livraison",
+  "status_7": "Exception",
+  "status_8": "Enregistré",
+  "packageName": "Colis %s"
 }

package/admin/i18n/it.json

@@ -3,8 +3,6 @@
   "apiKeyInfo": "Inserisci la tua chiave API parcel.app. È necessario un abbonamento Premium. Ottieni la tua chiave su web.parcelapp.net → pannello API.",
   "label_apiKey": "Chiave API",
   "btn_checkConnection": "Testa connessione",
-  "msg_connectionOk": "Connessione riuscita!",
-  "msg_connectionFailed": "Connessione fallita!",
   "header_polling": "Polling",
   "label_pollInterval": "Intervallo di polling (minuti)",
   "tooltip_pollInterval": "Frequenza di aggiornamento delle consegne (5-60 minuti, predefinito: 10). Limite: 20 richieste/ora.",
@@ -36,5 +34,15 @@
   "estimateOverdue": "in ritardo",
   "estimateToday": "oggi",
   "estimateTomorrow": "domani",
-  "estimateDays": "tra %d giorni"
+  "estimateDays": "tra %s giorni",
+  "status_0": "Consegnato",
+  "status_1": "Congelato",
+  "status_2": "In transito",
+  "status_3": "In attesa di ritiro",
+  "status_4": "In consegna",
+  "status_5": "Non trovato",
+  "status_6": "Consegna fallita",
+  "status_7": "Eccezione",
+  "status_8": "Registrato",
+  "packageName": "Pacco %s"
 }

package/admin/i18n/nl.json

@@ -3,8 +3,6 @@
   "apiKeyInfo": "Voer je parcel.app API-sleutel in. Een Premium-abonnement is vereist. Haal je sleutel op via web.parcelapp.net → API-paneel.",
   "label_apiKey": "API-sleutel",
   "btn_checkConnection": "Verbinding testen",
-  "msg_connectionOk": "Verbinding succesvol!",
-  "msg_connectionFailed": "Verbinding mislukt!",
   "header_polling": "Polling",
   "label_pollInterval": "Polling-interval (minuten)",
   "tooltip_pollInterval": "Hoe vaak bezorgingsupdates ophalen (5-60 minuten, standaard: 10). Limiet: 20 verzoeken/uur.",
@@ -36,5 +34,15 @@
   "estimateOverdue": "te laat",
   "estimateToday": "vandaag",
   "estimateTomorrow": "morgen",
-  "estimateDays": "over %d dagen"
+  "estimateDays": "over %s dagen",
+  "status_0": "Bezorgd",
+  "status_1": "Bevroren",
+  "status_2": "Onderweg",
+  "status_3": "Wacht op ophaling",
+  "status_4": "Wordt bezorgd",
+  "status_5": "Niet gevonden",
+  "status_6": "Bezorgpoging mislukt",
+  "status_7": "Uitzondering",
+  "status_8": "Geregistreerd",
+  "packageName": "Pakket %s"
 }

package/admin/i18n/pl.json

@@ -3,8 +3,6 @@
   "apiKeyInfo": "Wprowadź klucz API parcel.app. Wymagana subskrypcja Premium. Uzyskaj klucz na web.parcelapp.net → panel API.",
   "label_apiKey": "Klucz API",
   "btn_checkConnection": "Testuj połączenie",
-  "msg_connectionOk": "Połączenie udane!",
-  "msg_connectionFailed": "Połączenie nieudane!",
   "header_polling": "Odpytywanie",
   "label_pollInterval": "Interwał odpytywania (minuty)",
   "tooltip_pollInterval": "Jak często pobierać aktualizacje dostaw (5-60 minut, domyślnie: 10). Limit: 20 zapytań/godzinę.",
@@ -36,5 +34,15 @@
   "estimateOverdue": "zaległe",
   "estimateToday": "dzisiaj",
   "estimateTomorrow": "jutro",
-  "estimateDays": "za %d dni"
+  "estimateDays": "za %s dni",
+  "status_0": "Dostarczone",
+  "status_1": "Zamrożone",
+  "status_2": "W drodze",
+  "status_3": "Oczekuje na odbiór",
+  "status_4": "W doręczeniu",
+  "status_5": "Nie znaleziono",
+  "status_6": "Nieudana próba doręczenia",
+  "status_7": "Wyjątek",
+  "status_8": "Zarejestrowane",
+  "packageName": "Paczka %s"
 }

package/admin/i18n/pt.json

@@ -3,8 +3,6 @@
   "apiKeyInfo": "Insira sua chave API do parcel.app. É necessária uma assinatura Premium. Obtenha sua chave em web.parcelapp.net → painel API.",
   "label_apiKey": "Chave API",
   "btn_checkConnection": "Testar Conexão",
-  "msg_connectionOk": "Conexão bem-sucedida!",
-  "msg_connectionFailed": "Falha na conexão!",
   "header_polling": "Consulta",
   "label_pollInterval": "Intervalo de consulta (minutos)",
   "tooltip_pollInterval": "Com que frequência buscar atualizações de entrega (5-60 minutos, padrão: 10). Limite: 20 solicitações/hora.",
@@ -36,5 +34,15 @@
   "estimateOverdue": "atrasado",
   "estimateToday": "hoje",
   "estimateTomorrow": "amanhã",
-  "estimateDays": "em %d dias"
+  "estimateDays": "em %s dias",
+  "status_0": "Entregue",
+  "status_1": "Congelado",
+  "status_2": "Em trânsito",
+  "status_3": "Aguardando recolha",
+  "status_4": "Em entrega",
+  "status_5": "Não encontrado",
+  "status_6": "Tentativa de entrega falhou",
+  "status_7": "Exceção",
+  "status_8": "Registado",
+  "packageName": "Encomenda %s"
 }

package/admin/i18n/ru.json

@@ -3,8 +3,6 @@
   "apiKeyInfo": "Введите API-ключ parcel.app. Требуется Premium-подписка. Получите ключ на web.parcelapp.net → раздел API.",
   "label_apiKey": "API-ключ",
   "btn_checkConnection": "Проверить соединение",
-  "msg_connectionOk": "Соединение успешно!",
-  "msg_connectionFailed": "Ошибка соединения!",
   "header_polling": "Опрос",
   "label_pollInterval": "Интервал опроса (минуты)",
   "tooltip_pollInterval": "Как часто получать обновления доставки (5-60 минут, по умолчанию: 10). Лимит: 20 запросов/час.",
@@ -36,5 +34,15 @@
   "estimateOverdue": "просрочено",
   "estimateToday": "сегодня",
   "estimateTomorrow": "завтра",
-  "estimateDays": "через %d дн."
+  "estimateDays": "через %s дн.",
+  "status_0": "Доставлено",
+  "status_1": "Заморожено",
+  "status_2": "В пути",
+  "status_3": "Ожидает получения",
+  "status_4": "Доставляется",
+  "status_5": "Не найдено",
+  "status_6": "Неудачная доставка",
+  "status_7": "Исключение",
+  "status_8": "Зарегистрировано",
+  "packageName": "Посылка %s"
 }

package/admin/i18n/uk.json

@@ -3,8 +3,6 @@
   "apiKeyInfo": "Введіть ваш API-ключ parcel.app. Потрібна Premium-підписка. Отримайте ключ на web.parcelapp.net → панель API.",
   "label_apiKey": "API-ключ",
   "btn_checkConnection": "Перевірити з'єднання",
-  "msg_connectionOk": "З'єднання успішне!",
-  "msg_connectionFailed": "Помилка з'єднання!",
   "header_polling": "Опитування",
   "label_pollInterval": "Інтервал опитування (хвилини)",
   "tooltip_pollInterval": "Як часто отримувати оновлення доставки (5-60 хвилин, за замовчуванням: 10). Ліміт: 20 запитів/годину.",
@@ -36,5 +34,15 @@
   "estimateOverdue": "прострочено",
   "estimateToday": "сьогодні",
   "estimateTomorrow": "завтра",
-  "estimateDays": "через %d дн."
+  "estimateDays": "через %s дн.",
+  "status_0": "Доставлено",
+  "status_1": "Заморожено",
+  "status_2": "В дорозі",
+  "status_3": "Очікує отримання",
+  "status_4": "Доставляється",
+  "status_5": "Не знайдено",
+  "status_6": "Невдала спроба доставки",
+  "status_7": "Виняток",
+  "status_8": "Зареєстровано",
+  "packageName": "Посилка %s"
 }

package/admin/i18n/zh-cn.json

@@ -3,8 +3,6 @@
   "apiKeyInfo": "输入你的 parcel.app API 密钥。需要 Premium 订阅。在 web.parcelapp.net → API 面板获取密钥。",
   "label_apiKey": "API 密钥",
   "btn_checkConnection": "测试连接",
-  "msg_connectionOk": "连接成功！",
-  "msg_connectionFailed": "连接失败！",
   "header_polling": "轮询",
   "label_pollInterval": "轮询间隔（分钟）",
   "tooltip_pollInterval": "多久获取一次快递更新（5-60分钟，默认：10）。速率限制：20次请求/小时。",
@@ -36,5 +34,15 @@
   "estimateOverdue": "已逾期",
   "estimateToday": "今天",
   "estimateTomorrow": "明天",
-  "estimateDays": "%d 天后"
+  "estimateDays": "%s 天后",
+  "status_0": "已送达",
+  "status_1": "已冻结",
+  "status_2": "运输中",
+  "status_3": "等待取件",
+  "status_4": "派送中",
+  "status_5": "未找到",
+  "status_6": "派送失败",
+  "status_7": "异常",
+  "status_8": "已登记",
+  "packageName": "包裹 %s"
 }

package/admin/jsonConfig.json

@@ -35,10 +35,6 @@
       "label": "btn_checkConnection",
       "command": "checkConnection",
       "jsonData": "{\"apiKey\": \"${data.apiKey}\"}",
-      "result": {
-        "okText": "msg_connectionOk",
-        "errorText": "msg_connectionFailed"
-      },
       "xs": 12,
       "sm": 12,
       "md": 4,

package/build/lib/coerce.js

@@ -21,7 +21,8 @@ __export(coerce_exports, {
   coerceClampedInt: () => coerceClampedInt,
   coerceFiniteNumber: () => coerceFiniteNumber,
   errText: () => errText,
-  isTrueish: () => isTrueish
+  isTrueish: () => isTrueish,
+  oneLine: () => oneLine
 });
 module.exports = __toCommonJS(coerce_exports);
 const DECIMAL_NUMBER_RE = /^-?\d+(\.\d+)?$/;
@@ -77,11 +78,15 @@ function coerceClampedInt(raw, min, max, defaultValue) {
   }
   return Math.max(min, Math.min(max, Math.floor(n)));
 }
+function oneLine(value) {
+  return value.replace(/[\r\n\t\0\v\f\u2028\u2029]+/g, " ");
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   coerceClampedInt,
   coerceFiniteNumber,
   errText,
-  isTrueish
+  isTrueish,
+  oneLine
 });
 //# sourceMappingURL=coerce.js.map

package/build/lib/coerce.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/coerce.ts"],
-  "sourcesContent": ["/**\n * Boundary coercion helpers for external API data.\n *\n * The parcel.app API is documented but field types still drift in practice\n * (rare success-flag returned as `\"true\"` string, occasional null where a\n * number is expected). These helpers guard against NaN/Infinity/non-string\n * values reaching ioBroker states.\n */\n\n// Strict decimal regex \u2014 only optional minus sign + digits + optional fractional part.\n// Rejects HEX (`0x...`), exponential (`1e3`), Infinity, NaN, leading/trailing whitespace.\n// Hassemu (E8 in v1.9.0) hardened the same coerce-helper this way; homewizard\n// adopted it in v0.7.2 (D8). Consistent with both adapters.\nconst DECIMAL_NUMBER_RE = /^-?\\d+(\\.\\d+)?$/;\n\n/**\n * Coerce to a finite number or null.\n * Accepts numbers directly; parses strict decimal strings; rejects NaN, Infinity,\n * HEX (`0x...`) and exponential notation (`1e3`).\n *\n * @param value Unknown external value\n */\nexport function coerceFiniteNumber(value: unknown): number | null {\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) ? value : null;\n  }\n  if (typeof value === \"string\" && DECIMAL_NUMBER_RE.test(value)) {\n    const n = Number(value);\n    return Number.isFinite(n) ? n : null;\n  }\n  return null;\n}\n\n/**\n * Coerce a parcel.app `success` flag. The API returns a real boolean in normal\n * operation, but the guard accepts common string/number encodings (`1`, `\"true\"`,\n * `\"1\"`) so a one-off drift doesn't break the entire poll cycle.\n *\n * @param v Value to interpret as a success flag\n */\nexport function isTrueish(v: unknown): boolean {\n  if (typeof v === \"boolean\") {\n    return v;\n  }\n  if (typeof v === \"number\") {\n    return v === 1;\n  }\n  if (typeof v === \"string\") {\n    const s = v.toLowerCase();\n    return s === \"true\" || s === \"1\";\n  }\n  return false;\n}\n\n/**\n * Extract a log-friendly message from a thrown / rejected value. Centralizes the\n * `err instanceof Error ? err.message : String(err)` pattern that otherwise\n * gets repeated at every catch-site. Plain objects are JSON-stringified so a\n * `[object Object]` log is avoided when callers throw bag-of-fields.\n *\n * @param err Caught value of unknown shape (Error, string, undefined, ...).\n */\nexport function errText(err: unknown): string {\n  if (err instanceof Error) {\n    return err.message;\n  }\n  if (err === null) {\n    return \"null\";\n  }\n  if (err === undefined) {\n    return \"undefined\";\n  }\n  if (typeof err === \"string\") {\n    return err;\n  }\n  if (typeof err === \"number\" || typeof err === \"boolean\" || typeof err === \"bigint\") {\n    return String(err);\n  }\n  // Plain objects + symbols would otherwise stringify to \"[object Object]\" / fail.\n  // Prefer JSON for the common case so the log is at least diagnosable.\n  try {\n    return JSON.stringify(err);\n  } catch {\n    return Object.prototype.toString.call(err);\n  }\n}\n\n/**\n * v0.4.2 (X5): coerce an admin-config integer setting (number-or-string)\n * to a finite, clamped integer. Returns `defaultValue` for non-finite\n * input \u2014 guards against `setInterval(fn, NaN)` tight-loops when the\n * config field happens to come back as a string from the admin UI.\n *\n * @param raw Raw value from `this.config.<field>`.\n * @param min Inclusive lower bound.\n * @param max Inclusive upper bound.\n * @param defaultValue Fallback when raw is missing or unparseable.\n */\nexport function coerceClampedInt(raw: unknown, min: number, max: number, defaultValue: number): number {\n  const n = typeof raw === \"number\" ? raw : typeof raw === \"string\" ? parseFloat(raw) : NaN;\n  if (!Number.isFinite(n)) {\n    return defaultValue;\n  }\n  return Math.max(min, Math.min(max, Math.floor(n)));\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,MAAM,oBAAoB;AASnB,SAAS,mBAAmB,OAA+B;AAChE,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;AAAA,EAC1C;AACA,MAAI,OAAO,UAAU,YAAY,kBAAkB,KAAK,KAAK,GAAG;AAC9D,UAAM,IAAI,OAAO,KAAK;AACtB,WAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAAA,EAClC;AACA,SAAO;AACT;AASO,SAAS,UAAU,GAAqB;AAC7C,MAAI,OAAO,MAAM,WAAW;AAC1B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,MAAM,UAAU;AACzB,WAAO,MAAM;AAAA,EACf;AACA,MAAI,OAAO,MAAM,UAAU;AACzB,UAAM,IAAI,EAAE,YAAY;AACxB,WAAO,MAAM,UAAU,MAAM;AAAA,EAC/B;AACA,SAAO;AACT;AAUO,SAAS,QAAQ,KAAsB;AAC5C,MAAI,eAAe,OAAO;AACxB,WAAO,IAAI;AAAA,EACb;AACA,MAAI,QAAQ,MAAM;AAChB,WAAO;AAAA,EACT;AACA,MAAI,QAAQ,QAAW;AACrB,WAAO;AAAA,EACT;AACA,MAAI,OAAO,QAAQ,UAAU;AAC3B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,aAAa,OAAO,QAAQ,UAAU;AAClF,WAAO,OAAO,GAAG;AAAA,EACnB;AAGA,MAAI;AACF,WAAO,KAAK,UAAU,GAAG;AAAA,EAC3B,QAAQ;AACN,WAAO,OAAO,UAAU,SAAS,KAAK,GAAG;AAAA,EAC3C;AACF;AAaO,SAAS,iBAAiB,KAAc,KAAa,KAAa,cAA8B;AACrG,QAAM,IAAI,OAAO,QAAQ,WAAW,MAAM,OAAO,QAAQ,WAAW,WAAW,GAAG,IAAI;AACtF,MAAI,CAAC,OAAO,SAAS,CAAC,GAAG;AACvB,WAAO;AAAA,EACT;AACA,SAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC;AACnD;",
+  "sourcesContent": ["/**\n * Boundary coercion helpers for external API data.\n *\n * The parcel.app API is documented but field types still drift in practice\n * (rare success-flag returned as `\"true\"` string, occasional null where a\n * number is expected). These helpers guard against NaN/Infinity/non-string\n * values reaching ioBroker states.\n */\n\n// Strict decimal regex \u2014 only optional minus sign + digits + optional fractional part.\n// Rejects HEX (`0x...`), exponential (`1e3`), Infinity, NaN, leading/trailing whitespace.\n// Hassemu (E8 in v1.9.0) hardened the same coerce-helper this way; homewizard\n// adopted it in v0.7.2 (D8). Consistent with both adapters.\nconst DECIMAL_NUMBER_RE = /^-?\\d+(\\.\\d+)?$/;\n\n/**\n * Coerce to a finite number or null.\n * Accepts numbers directly; parses strict decimal strings; rejects NaN, Infinity,\n * HEX (`0x...`) and exponential notation (`1e3`).\n *\n * @param value Unknown external value\n */\nexport function coerceFiniteNumber(value: unknown): number | null {\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) ? value : null;\n  }\n  if (typeof value === \"string\" && DECIMAL_NUMBER_RE.test(value)) {\n    const n = Number(value);\n    return Number.isFinite(n) ? n : null;\n  }\n  return null;\n}\n\n/**\n * Coerce a parcel.app `success` flag. The API returns a real boolean in normal\n * operation, but the guard accepts common string/number encodings (`1`, `\"true\"`,\n * `\"1\"`) so a one-off drift doesn't break the entire poll cycle.\n *\n * @param v Value to interpret as a success flag\n */\nexport function isTrueish(v: unknown): boolean {\n  if (typeof v === \"boolean\") {\n    return v;\n  }\n  if (typeof v === \"number\") {\n    return v === 1;\n  }\n  if (typeof v === \"string\") {\n    const s = v.toLowerCase();\n    return s === \"true\" || s === \"1\";\n  }\n  return false;\n}\n\n/**\n * Extract a log-friendly message from a thrown / rejected value. Centralizes the\n * `err instanceof Error ? err.message : String(err)` pattern that otherwise\n * gets repeated at every catch-site. Plain objects are JSON-stringified so a\n * `[object Object]` log is avoided when callers throw bag-of-fields.\n *\n * @param err Caught value of unknown shape (Error, string, undefined, ...).\n */\nexport function errText(err: unknown): string {\n  if (err instanceof Error) {\n    return err.message;\n  }\n  if (err === null) {\n    return \"null\";\n  }\n  if (err === undefined) {\n    return \"undefined\";\n  }\n  if (typeof err === \"string\") {\n    return err;\n  }\n  if (typeof err === \"number\" || typeof err === \"boolean\" || typeof err === \"bigint\") {\n    return String(err);\n  }\n  // Plain objects + symbols would otherwise stringify to \"[object Object]\" / fail.\n  // Prefer JSON for the common case so the log is at least diagnosable.\n  try {\n    return JSON.stringify(err);\n  } catch {\n    return Object.prototype.toString.call(err);\n  }\n}\n\n/**\n * v0.4.2 (X5): coerce an admin-config integer setting (number-or-string)\n * to a finite, clamped integer. Returns `defaultValue` for non-finite\n * input \u2014 guards against `setInterval(fn, NaN)` tight-loops when the\n * config field happens to come back as a string from the admin UI.\n *\n * @param raw Raw value from `this.config.<field>`.\n * @param min Inclusive lower bound.\n * @param max Inclusive upper bound.\n * @param defaultValue Fallback when raw is missing or unparseable.\n */\nexport function coerceClampedInt(raw: unknown, min: number, max: number, defaultValue: number): number {\n  const n = typeof raw === \"number\" ? raw : typeof raw === \"string\" ? parseFloat(raw) : NaN;\n  if (!Number.isFinite(n)) {\n    return defaultValue;\n  }\n  return Math.max(min, Math.min(max, Math.floor(n)));\n}\n\n/**\n * Collapse control-character runs (CR / LF / TAB / NUL / VT / FF and the\n * Unicode line separators U+2028/U+2029) in an untrusted string to a single\n * space before it is interpolated into a log line \u2014 prevents log-injection\n * (a forged second log line) from external values (tracking number, carrier\n * code, raw API body, collision raw-key with its NUL separator, \u2026). Fleet\n * convention (hassemu/hueemu v1.36.0 S4); widened in v0.10.0 (I10).\n *\n * @param value Untrusted string to flatten for single-line logging.\n */\nexport function oneLine(value: string): string {\n  return value.replace(/[\\r\\n\\t\\0\\v\\f\\u2028\\u2029]+/g, \" \");\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,MAAM,oBAAoB;AASnB,SAAS,mBAAmB,OAA+B;AAChE,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;AAAA,EAC1C;AACA,MAAI,OAAO,UAAU,YAAY,kBAAkB,KAAK,KAAK,GAAG;AAC9D,UAAM,IAAI,OAAO,KAAK;AACtB,WAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAAA,EAClC;AACA,SAAO;AACT;AASO,SAAS,UAAU,GAAqB;AAC7C,MAAI,OAAO,MAAM,WAAW;AAC1B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,MAAM,UAAU;AACzB,WAAO,MAAM;AAAA,EACf;AACA,MAAI,OAAO,MAAM,UAAU;AACzB,UAAM,IAAI,EAAE,YAAY;AACxB,WAAO,MAAM,UAAU,MAAM;AAAA,EAC/B;AACA,SAAO;AACT;AAUO,SAAS,QAAQ,KAAsB;AAC5C,MAAI,eAAe,OAAO;AACxB,WAAO,IAAI;AAAA,EACb;AACA,MAAI,QAAQ,MAAM;AAChB,WAAO;AAAA,EACT;AACA,MAAI,QAAQ,QAAW;AACrB,WAAO;AAAA,EACT;AACA,MAAI,OAAO,QAAQ,UAAU;AAC3B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,aAAa,OAAO,QAAQ,UAAU;AAClF,WAAO,OAAO,GAAG;AAAA,EACnB;AAGA,MAAI;AACF,WAAO,KAAK,UAAU,GAAG;AAAA,EAC3B,QAAQ;AACN,WAAO,OAAO,UAAU,SAAS,KAAK,GAAG;AAAA,EAC3C;AACF;AAaO,SAAS,iBAAiB,KAAc,KAAa,KAAa,cAA8B;AACrG,QAAM,IAAI,OAAO,QAAQ,WAAW,MAAM,OAAO,QAAQ,WAAW,WAAW,GAAG,IAAI;AACtF,MAAI,CAAC,OAAO,SAAS,CAAC,GAAG;AACvB,WAAO;AAAA,EACT;AACA,SAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC;AACnD;AAYO,SAAS,QAAQ,OAAuB;AAC7C,SAAO,MAAM,QAAQ,gCAAgC,GAAG;AAC1D;",
   "names": []
 }

package/build/lib/i18n.js

@@ -18,15 +18,42 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var i18n_exports = {};
 __export(i18n_exports, {
-  tName: () => tName
+  packageName: () => packageName,
+  statusLabel: () => statusLabel,
+  tName: () => tName,
+  tText: () => tText
 });
 module.exports = __toCommonJS(i18n_exports);
 var import_adapter_core = require("@iobroker/adapter-core");
 function tName(key) {
   return import_adapter_core.I18n.getTranslatedObject(key);
 }
+function tText(key, ...args) {
+  return import_adapter_core.I18n.translate(key, ...args);
+}
+const STATUS_KEYS = {
+  0: "status_0",
+  1: "status_1",
+  2: "status_2",
+  3: "status_3",
+  4: "status_4",
+  5: "status_5",
+  6: "status_6",
+  7: "status_7",
+  8: "status_8"
+};
+function statusLabel(code) {
+  const key = STATUS_KEYS[code];
+  return key === void 0 ? void 0 : import_adapter_core.I18n.translate(key);
+}
+function packageName(trackingNumber) {
+  return import_adapter_core.I18n.getTranslatedObject("packageName", trackingNumber);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  tName
+  packageName,
+  statusLabel,
+  tName,
+  tText
 });
 //# sourceMappingURL=i18n.js.map

package/build/lib/i18n.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/i18n.ts"],
-  "sourcesContent": ["import { I18n } from \"@iobroker/adapter-core\";\nimport type translations from \"../../admin/i18n/en.json\";\n\ntype I18nKey = keyof typeof translations;\n\n/**\n * @param key Translation key from admin/i18n/en.json\n */\nexport function tName(key: I18nKey): ioBroker.StringOrTranslated {\n  return I18n.getTranslatedObject(key);\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAAqB;AAQd,SAAS,MAAM,KAA2C;AAC/D,SAAO,yBAAK,oBAAoB,GAAG;AACrC;",
+  "sourcesContent": ["import { I18n } from \"@iobroker/adapter-core\";\nimport type translations from \"../../admin/i18n/en.json\";\n\ntype I18nKey = keyof typeof translations;\n\n/**\n * @param key Translation key from admin/i18n/en.json\n */\nexport function tName(key: I18nKey): ioBroker.StringOrTranslated {\n  return I18n.getTranslatedObject(key);\n}\n\n/**\n * Type-safe wrapper around I18n.translate \u2014 a typo'd key is a compile error,\n * matching the guarantee tName already gives object names (v0.10.0, L13).\n * `%s` placeholders are filled from args, rendered in the system language.\n *\n * @param key Translation key from admin/i18n/en.json\n * @param args Values substituted for `%s` placeholders\n */\nexport function tText(key: I18nKey, ...args: (string | number | boolean | null)[]): string {\n  return I18n.translate(key, ...args);\n}\n\n/** status_code \u2192 i18n key. `satisfies` pins every entry to a real key in en.json. */\nconst STATUS_KEYS = {\n  0: \"status_0\",\n  1: \"status_1\",\n  2: \"status_2\",\n  3: \"status_3\",\n  4: \"status_4\",\n  5: \"status_5\",\n  6: \"status_6\",\n  7: \"status_7\",\n  8: \"status_8\",\n} as const satisfies Record<number, I18nKey>;\n\n/**\n * Localized status label for a parsed status code, or undefined for codes the\n * table does not know (API drift) \u2014 the caller renders its own fallback.\n * Replaces the former STATUS_LABELS table in types.ts (v0.10.0, L20): one\n * translation system (admin/i18n via adapter-core I18n) instead of two.\n *\n * @param code Parsed numeric status code\n */\nexport function statusLabel(code: number): string | undefined {\n  const key = (STATUS_KEYS as Partial<Record<number, I18nKey>>)[code];\n  return key === undefined ? undefined : I18n.translate(key);\n}\n\n/**\n * Localized fallback device name (\"Package <tracking>\") as a translation\n * object \u2014 getTranslatedObject substitutes `%s` in every language, so the\n * one previously hard-English user-facing label is localized too (v0.10.0, L18).\n *\n * @param trackingNumber Tracking number (or package id) interpolated into the name\n */\nexport function packageName(trackingNumber: string): ioBroker.StringOrTranslated {\n  return I18n.getTranslatedObject(\"packageName\", trackingNumber);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAAqB;AAQd,SAAS,MAAM,KAA2C;AAC/D,SAAO,yBAAK,oBAAoB,GAAG;AACrC;AAUO,SAAS,MAAM,QAAiB,MAAoD;AACzF,SAAO,yBAAK,UAAU,KAAK,GAAG,IAAI;AACpC;AAGA,MAAM,cAAc;AAAA,EAClB,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;AAUO,SAAS,YAAY,MAAkC;AAC5D,QAAM,MAAO,YAAiD,IAAI;AAClE,SAAO,QAAQ,SAAY,SAAY,yBAAK,UAAU,GAAG;AAC3D;AASO,SAAS,YAAY,gBAAqD;AAC/E,SAAO,yBAAK,oBAAoB,eAAe,cAAc;AAC/D;",
   "names": []
 }