iobroker.parcelapp 0.2.7 → 0.2.8

package/README.md

@@ -94,6 +94,9 @@ parcelapp.0.
 
 ## Changelog
 
+### 0.2.8 (2026-04-05)
+- Clean up empty parent folders after removing obsolete states
+
 ### 0.2.7 (2026-04-05)
 - Consistent UI labels across all adapters
 
@@ -112,9 +115,6 @@ parcelapp.0.
 ### 0.2.2 (2026-03-28)
 - Adapter-managed timers, CI on Windows/macOS, consistent i18n keys, full MIT license in README
 
-### 0.2.1 (2026-03-25)
-- Robust error handling: rate limit detection, connection error deduplication, poll throttling
-
 Older changelog: [CHANGELOG.md](CHANGELOG.md)
 
 ---

package/build/main.js

@@ -148,6 +148,17 @@ class ParcelappAdapter extends utils.Adapter {
       if (obj) {
         await this.delObjectAsync(stateId);
         this.log.debug(`Removed obsolete state: ${stateId}`);
+        const parentId = stateId.includes(".") ? stateId.substring(0, stateId.lastIndexOf(".")) : null;
+        if (parentId) {
+          const children = await this.getObjectListAsync({
+            startkey: `${this.namespace}.${parentId}.`,
+            endkey: `${this.namespace}.${parentId}.\u9999`
+          });
+          if ((children == null ? void 0 : children.rows.length) === 0) {
+            await this.delObjectAsync(parentId);
+            this.log.debug(`Removed empty parent: ${parentId}`);
+          }
+        }
       }
     }
   }

package/build/main.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts"],
-  "sourcesContent": ["import * as utils from \"@iobroker/adapter-core\";\nimport { ParcelClient } from \"./lib/parcel-client\";\nimport { StateManager } from \"./lib/state-manager\";\nimport \"./lib/types\";\n\nconst MIN_POLL_INTERVAL = 5;\nconst MAX_POLL_INTERVAL = 60;\nconst DEFAULT_POLL_INTERVAL = 10;\nconst MIN_POLL_GAP_MS = 60_000; // Minimum 60s between polls\n\n/** ioBroker adapter for parcel.app package tracking */\nclass ParcelappAdapter extends utils.Adapter {\n  private client: ParcelClient | null = null;\n  private stateManager: StateManager | null = null;\n  private pollTimer: ioBroker.Interval | undefined = undefined;\n  private isPolling = false;\n  private lastPollTime = 0;\n  private rateLimitedUntil = 0;\n  private lastErrorCode = \"\";\n\n  /** @param options Adapter options */\n  public constructor(options: Partial<utils.AdapterOptions> = {}) {\n    super({\n      ...options,\n      name: \"parcelapp\",\n    });\n    this.on(\"ready\", this.onReady.bind(this));\n    this.on(\"unload\", this.onUnload.bind(this));\n    this.on(\"message\", this.onMessage.bind(this));\n  }\n\n  private async onReady(): Promise<void> {\n    await this.setStateAsync(\"info.connection\", { val: false, ack: true });\n\n    // Validate config\n    const { apiKey } = this.config;\n    if (!apiKey || apiKey.trim().length < 10) {\n      this.log.error(\n        \"No valid API key configured \u2014 please enter your parcel.app API key in the adapter settings\",\n      );\n      return;\n    }\n\n    // Initialize\n    this.client = new ParcelClient(apiKey.trim());\n    this.stateManager = new StateManager(this);\n\n    // Cleanup obsolete states\n    await this.cleanupObsoleteStates();\n\n    // Initial poll\n    await this.poll();\n\n    // Set up recurring poll\n    const interval = Math.max(\n      MIN_POLL_INTERVAL,\n      Math.min(\n        MAX_POLL_INTERVAL,\n        this.config.pollInterval ?? DEFAULT_POLL_INTERVAL,\n      ),\n    );\n    const intervalMs = interval * 60 * 1000;\n    this.pollTimer = this.setInterval(() => void this.poll(), intervalMs);\n\n    this.log.info(\n      `Parcel tracking started \u2014 polling every ${interval} minutes`,\n    );\n  }\n\n  private onUnload(callback: () => void): void {\n    if (this.pollTimer) {\n      this.clearInterval(this.pollTimer);\n      this.pollTimer = undefined;\n    }\n    void this.setState(\"info.connection\", { val: false, ack: true });\n    callback();\n  }\n\n  private async onMessage(obj: ioBroker.Message): Promise<void> {\n    if (!obj?.command) {\n      return;\n    }\n\n    switch (obj.command) {\n      case \"checkConnection\": {\n        const msg = obj.message as { apiKey?: string };\n        const key = msg?.apiKey?.trim() || \"\";\n        if (!key || key.length < 10) {\n          this.sendTo(\n            obj.from,\n            obj.command,\n            {\n              success: false,\n              message: \"API key is too short\",\n            },\n            obj.callback,\n          );\n          return;\n        }\n        const testClient = new ParcelClient(key);\n        const result = await testClient.testConnection();\n        this.sendTo(obj.from, obj.command, result, obj.callback);\n        break;\n      }\n      case \"addDelivery\": {\n        if (!this.client) {\n          this.sendTo(\n            obj.from,\n            obj.command,\n            {\n              success: false,\n              error_message: \"Adapter not initialized\",\n            },\n            obj.callback,\n          );\n          return;\n        }\n        const request = obj.message as {\n          tracking_number: string;\n          carrier_code: string;\n          description: string;\n        };\n        const addResult = await this.client.addDelivery(request);\n        this.sendTo(obj.from, obj.command, addResult, obj.callback);\n        if (addResult.success) {\n          // Trigger immediate poll to pick up the new delivery\n          void this.poll();\n        }\n        break;\n      }\n      default:\n        this.sendTo(\n          obj.from,\n          obj.command,\n          { error: \"Unknown command\" },\n          obj.callback,\n        );\n    }\n  }\n\n  private async cleanupObsoleteStates(): Promise<void> {\n    const obsoleteStates = [\n      \"summary.json\", // removed in 0.2.0\n    ];\n    for (const stateId of obsoleteStates) {\n      const obj = await this.getObjectAsync(stateId);\n      if (obj) {\n        await this.delObjectAsync(stateId);\n        this.log.debug(`Removed obsolete state: ${stateId}`);\n      }\n    }\n  }\n\n  /**\n   * Classify an error for deduplication and log-level decisions.\n   *\n   * @param error The error to classify\n   */\n  private classifyError(error: Error & { code?: string }): string {\n    if (error.code === \"RATE_LIMITED\") {\n      return \"RATE_LIMITED\";\n    }\n    if (error.code === \"INVALID_API_KEY\") {\n      return \"INVALID_API_KEY\";\n    }\n    // Network errors: DNS, connection refused, no internet\n    if (\n      error.code === \"ENOTFOUND\" ||\n      error.code === \"ECONNREFUSED\" ||\n      error.code === \"ECONNRESET\" ||\n      error.code === \"ENETUNREACH\" ||\n      error.code === \"EAI_AGAIN\"\n    ) {\n      return \"NETWORK\";\n    }\n    if (error.message.includes(\"timeout\") || error.code === \"ETIMEDOUT\") {\n      return \"TIMEOUT\";\n    }\n    return error.code || \"UNKNOWN\";\n  }\n\n  private async poll(): Promise<void> {\n    if (this.isPolling || !this.client || !this.stateManager) {\n      return;\n    }\n\n    const now = Date.now();\n\n    // Skip if rate limited\n    if (now < this.rateLimitedUntil) {\n      const waitMin = Math.ceil((this.rateLimitedUntil - now) / 60_000);\n      this.log.debug(\n        `Skipping poll \u2014 rate limited for ${waitMin} more minute(s)`,\n      );\n      return;\n    }\n\n    // Throttle: minimum gap between polls\n    if (now - this.lastPollTime < MIN_POLL_GAP_MS) {\n      this.log.debug(\"Skipping poll \u2014 too soon after last poll\");\n      return;\n    }\n\n    this.isPolling = true;\n    this.lastPollTime = now;\n    try {\n      // When keeping delivered packages, use \"recent\" to get them from API\n      const autoRemove = this.config.autoRemoveDelivered !== false;\n      const deliveries = await this.client.getDeliveries(\n        autoRemove ? \"active\" : \"recent\",\n      );\n\n      // Reset error state on success\n      this.rateLimitedUntil = 0;\n      if (this.lastErrorCode) {\n        this.log.info(\"Connection restored\");\n        this.lastErrorCode = \"\";\n      }\n      await this.setStateAsync(\"info.connection\", { val: true, ack: true });\n\n      // Filter deliveries based on auto-remove setting\n      const visibleDeliveries = autoRemove\n        ? deliveries.filter((d) => parseInt(d.status_code, 10) !== 0)\n        : deliveries;\n\n      // Update each delivery\n      const activeIds: string[] = [];\n      for (const delivery of visibleDeliveries) {\n        const carrierName = await this.client.getCarrierName(\n          delivery.carrier_code,\n        );\n        await this.stateManager.updateDelivery(delivery, carrierName);\n        activeIds.push(this.stateManager.packageId(delivery));\n      }\n\n      // Cleanup stale deliveries\n      await this.stateManager.cleanupDeliveries(activeIds);\n\n      // Update summary\n      const summaryDeliveries = autoRemove\n        ? visibleDeliveries\n        : deliveries.filter((d) => parseInt(d.status_code, 10) !== 0);\n      await this.stateManager.updateSummary(summaryDeliveries);\n\n      this.log.debug(\n        `Polled ${visibleDeliveries.length} deliveries (${summaryDeliveries.length} active)`,\n      );\n    } catch (err) {\n      const error = err as Error & {\n        code?: string;\n        retryAfterSeconds?: number;\n      };\n\n      // Classify the error\n      const errorCode = this.classifyError(error);\n      const isRepeat = errorCode === this.lastErrorCode;\n      this.lastErrorCode = errorCode;\n\n      if (error.code === \"RATE_LIMITED\") {\n        const cooldownSec = error.retryAfterSeconds || 5 * 60;\n        this.rateLimitedUntil = Date.now() + cooldownSec * 1000;\n        this.log.warn(\n          `Rate limit hit \u2014 pausing API requests for ${Math.ceil(cooldownSec / 60)} minute(s)`,\n        );\n      } else if (error.code === \"INVALID_API_KEY\") {\n        // Always log \u2014 user must fix config\n        this.log.error(\n          \"Invalid API key \u2014 please check your parcel.app API key\",\n        );\n      } else if (isRepeat) {\n        // Same error as last time \u2014 don't spam the log\n        this.log.debug(`Poll failed (ongoing): ${error.message}`);\n      } else if (errorCode === \"NETWORK\") {\n        this.log.warn(`Cannot reach parcel.app API \u2014 will keep retrying`);\n      } else if (errorCode === \"TIMEOUT\") {\n        this.log.warn(`API request timeout \u2014 will retry next cycle`);\n      } else {\n        this.log.error(`Poll failed: ${error.message}`);\n      }\n\n      await this.setStateAsync(\"info.connection\", { val: false, ack: true });\n    } finally {\n      this.isPolling = false;\n    }\n  }\n}\n\nif (require.main !== module) {\n  module.exports = (options: Partial<utils.AdapterOptions> | undefined) =>\n    new ParcelappAdapter(options);\n} else {\n  (() => new ParcelappAdapter())();\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as utils from \"@iobroker/adapter-core\";\nimport { ParcelClient } from \"./lib/parcel-client\";\nimport { StateManager } from \"./lib/state-manager\";\nimport \"./lib/types\";\n\nconst MIN_POLL_INTERVAL = 5;\nconst MAX_POLL_INTERVAL = 60;\nconst DEFAULT_POLL_INTERVAL = 10;\nconst MIN_POLL_GAP_MS = 60_000; // Minimum 60s between polls\n\n/** ioBroker adapter for parcel.app package tracking */\nclass ParcelappAdapter extends utils.Adapter {\n  private client: ParcelClient | null = null;\n  private stateManager: StateManager | null = null;\n  private pollTimer: ioBroker.Interval | undefined = undefined;\n  private isPolling = false;\n  private lastPollTime = 0;\n  private rateLimitedUntil = 0;\n  private lastErrorCode = \"\";\n\n  /** @param options Adapter options */\n  public constructor(options: Partial<utils.AdapterOptions> = {}) {\n    super({\n      ...options,\n      name: \"parcelapp\",\n    });\n    this.on(\"ready\", this.onReady.bind(this));\n    this.on(\"unload\", this.onUnload.bind(this));\n    this.on(\"message\", this.onMessage.bind(this));\n  }\n\n  private async onReady(): Promise<void> {\n    await this.setStateAsync(\"info.connection\", { val: false, ack: true });\n\n    // Validate config\n    const { apiKey } = this.config;\n    if (!apiKey || apiKey.trim().length < 10) {\n      this.log.error(\n        \"No valid API key configured \u2014 please enter your parcel.app API key in the adapter settings\",\n      );\n      return;\n    }\n\n    // Initialize\n    this.client = new ParcelClient(apiKey.trim());\n    this.stateManager = new StateManager(this);\n\n    // Cleanup obsolete states\n    await this.cleanupObsoleteStates();\n\n    // Initial poll\n    await this.poll();\n\n    // Set up recurring poll\n    const interval = Math.max(\n      MIN_POLL_INTERVAL,\n      Math.min(\n        MAX_POLL_INTERVAL,\n        this.config.pollInterval ?? DEFAULT_POLL_INTERVAL,\n      ),\n    );\n    const intervalMs = interval * 60 * 1000;\n    this.pollTimer = this.setInterval(() => void this.poll(), intervalMs);\n\n    this.log.info(\n      `Parcel tracking started \u2014 polling every ${interval} minutes`,\n    );\n  }\n\n  private onUnload(callback: () => void): void {\n    if (this.pollTimer) {\n      this.clearInterval(this.pollTimer);\n      this.pollTimer = undefined;\n    }\n    void this.setState(\"info.connection\", { val: false, ack: true });\n    callback();\n  }\n\n  private async onMessage(obj: ioBroker.Message): Promise<void> {\n    if (!obj?.command) {\n      return;\n    }\n\n    switch (obj.command) {\n      case \"checkConnection\": {\n        const msg = obj.message as { apiKey?: string };\n        const key = msg?.apiKey?.trim() || \"\";\n        if (!key || key.length < 10) {\n          this.sendTo(\n            obj.from,\n            obj.command,\n            {\n              success: false,\n              message: \"API key is too short\",\n            },\n            obj.callback,\n          );\n          return;\n        }\n        const testClient = new ParcelClient(key);\n        const result = await testClient.testConnection();\n        this.sendTo(obj.from, obj.command, result, obj.callback);\n        break;\n      }\n      case \"addDelivery\": {\n        if (!this.client) {\n          this.sendTo(\n            obj.from,\n            obj.command,\n            {\n              success: false,\n              error_message: \"Adapter not initialized\",\n            },\n            obj.callback,\n          );\n          return;\n        }\n        const request = obj.message as {\n          tracking_number: string;\n          carrier_code: string;\n          description: string;\n        };\n        const addResult = await this.client.addDelivery(request);\n        this.sendTo(obj.from, obj.command, addResult, obj.callback);\n        if (addResult.success) {\n          // Trigger immediate poll to pick up the new delivery\n          void this.poll();\n        }\n        break;\n      }\n      default:\n        this.sendTo(\n          obj.from,\n          obj.command,\n          { error: \"Unknown command\" },\n          obj.callback,\n        );\n    }\n  }\n\n  private async cleanupObsoleteStates(): Promise<void> {\n    const obsoleteStates = [\n      \"summary.json\", // removed in 0.2.0\n    ];\n    for (const stateId of obsoleteStates) {\n      const obj = await this.getObjectAsync(stateId);\n      if (obj) {\n        await this.delObjectAsync(stateId);\n        this.log.debug(`Removed obsolete state: ${stateId}`);\n\n        // Clean up empty parent channel/folder\n        const parentId = stateId.includes(\".\")\n          ? stateId.substring(0, stateId.lastIndexOf(\".\"))\n          : null;\n        if (parentId) {\n          const children = await this.getObjectListAsync({\n            startkey: `${this.namespace}.${parentId}.`,\n            endkey: `${this.namespace}.${parentId}.\\u9999`,\n          });\n          if (children?.rows.length === 0) {\n            await this.delObjectAsync(parentId);\n            this.log.debug(`Removed empty parent: ${parentId}`);\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Classify an error for deduplication and log-level decisions.\n   *\n   * @param error The error to classify\n   */\n  private classifyError(error: Error & { code?: string }): string {\n    if (error.code === \"RATE_LIMITED\") {\n      return \"RATE_LIMITED\";\n    }\n    if (error.code === \"INVALID_API_KEY\") {\n      return \"INVALID_API_KEY\";\n    }\n    // Network errors: DNS, connection refused, no internet\n    if (\n      error.code === \"ENOTFOUND\" ||\n      error.code === \"ECONNREFUSED\" ||\n      error.code === \"ECONNRESET\" ||\n      error.code === \"ENETUNREACH\" ||\n      error.code === \"EAI_AGAIN\"\n    ) {\n      return \"NETWORK\";\n    }\n    if (error.message.includes(\"timeout\") || error.code === \"ETIMEDOUT\") {\n      return \"TIMEOUT\";\n    }\n    return error.code || \"UNKNOWN\";\n  }\n\n  private async poll(): Promise<void> {\n    if (this.isPolling || !this.client || !this.stateManager) {\n      return;\n    }\n\n    const now = Date.now();\n\n    // Skip if rate limited\n    if (now < this.rateLimitedUntil) {\n      const waitMin = Math.ceil((this.rateLimitedUntil - now) / 60_000);\n      this.log.debug(\n        `Skipping poll \u2014 rate limited for ${waitMin} more minute(s)`,\n      );\n      return;\n    }\n\n    // Throttle: minimum gap between polls\n    if (now - this.lastPollTime < MIN_POLL_GAP_MS) {\n      this.log.debug(\"Skipping poll \u2014 too soon after last poll\");\n      return;\n    }\n\n    this.isPolling = true;\n    this.lastPollTime = now;\n    try {\n      // When keeping delivered packages, use \"recent\" to get them from API\n      const autoRemove = this.config.autoRemoveDelivered !== false;\n      const deliveries = await this.client.getDeliveries(\n        autoRemove ? \"active\" : \"recent\",\n      );\n\n      // Reset error state on success\n      this.rateLimitedUntil = 0;\n      if (this.lastErrorCode) {\n        this.log.info(\"Connection restored\");\n        this.lastErrorCode = \"\";\n      }\n      await this.setStateAsync(\"info.connection\", { val: true, ack: true });\n\n      // Filter deliveries based on auto-remove setting\n      const visibleDeliveries = autoRemove\n        ? deliveries.filter((d) => parseInt(d.status_code, 10) !== 0)\n        : deliveries;\n\n      // Update each delivery\n      const activeIds: string[] = [];\n      for (const delivery of visibleDeliveries) {\n        const carrierName = await this.client.getCarrierName(\n          delivery.carrier_code,\n        );\n        await this.stateManager.updateDelivery(delivery, carrierName);\n        activeIds.push(this.stateManager.packageId(delivery));\n      }\n\n      // Cleanup stale deliveries\n      await this.stateManager.cleanupDeliveries(activeIds);\n\n      // Update summary\n      const summaryDeliveries = autoRemove\n        ? visibleDeliveries\n        : deliveries.filter((d) => parseInt(d.status_code, 10) !== 0);\n      await this.stateManager.updateSummary(summaryDeliveries);\n\n      this.log.debug(\n        `Polled ${visibleDeliveries.length} deliveries (${summaryDeliveries.length} active)`,\n      );\n    } catch (err) {\n      const error = err as Error & {\n        code?: string;\n        retryAfterSeconds?: number;\n      };\n\n      // Classify the error\n      const errorCode = this.classifyError(error);\n      const isRepeat = errorCode === this.lastErrorCode;\n      this.lastErrorCode = errorCode;\n\n      if (error.code === \"RATE_LIMITED\") {\n        const cooldownSec = error.retryAfterSeconds || 5 * 60;\n        this.rateLimitedUntil = Date.now() + cooldownSec * 1000;\n        this.log.warn(\n          `Rate limit hit \u2014 pausing API requests for ${Math.ceil(cooldownSec / 60)} minute(s)`,\n        );\n      } else if (error.code === \"INVALID_API_KEY\") {\n        // Always log \u2014 user must fix config\n        this.log.error(\n          \"Invalid API key \u2014 please check your parcel.app API key\",\n        );\n      } else if (isRepeat) {\n        // Same error as last time \u2014 don't spam the log\n        this.log.debug(`Poll failed (ongoing): ${error.message}`);\n      } else if (errorCode === \"NETWORK\") {\n        this.log.warn(`Cannot reach parcel.app API \u2014 will keep retrying`);\n      } else if (errorCode === \"TIMEOUT\") {\n        this.log.warn(`API request timeout \u2014 will retry next cycle`);\n      } else {\n        this.log.error(`Poll failed: ${error.message}`);\n      }\n\n      await this.setStateAsync(\"info.connection\", { val: false, ack: true });\n    } finally {\n      this.isPolling = false;\n    }\n  }\n}\n\nif (require.main !== module) {\n  module.exports = (options: Partial<utils.AdapterOptions> | undefined) =>\n    new ParcelappAdapter(options);\n} else {\n  (() => new ParcelappAdapter())();\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "parcelapp",
-    "version": "0.2.7",
+    "version": "0.2.8",
     "news": {
+      "0.2.8": {
+        "en": "Clean up empty parent folders after removing obsolete states",
+        "de": "Leere Eltern-Ordner nach Entfernen obsoleter States löschen",
+        "ru": "Удаление пустых родительских папок после удаления устаревших состояний",
+        "pt": "Limpar pastas pai vazias após remover estados obsoletos",
+        "nl": "Lege bovenliggende mappen opruimen na verwijderen van verouderde statussen",
+        "fr": "Nettoyage des dossiers parents vides après suppression des états obsolètes",
+        "it": "Pulizia delle cartelle padre vuote dopo la rimozione degli stati obsoleti",
+        "es": "Limpiar carpetas padre vacías después de eliminar estados obsoletos",
+        "pl": "Usuwanie pustych folderów nadrzędnych po usunięciu przestarzałych stanów",
+        "uk": "Видалення порожніх батьківських папок після видалення застарілих станів",
+        "zh-cn": "移除过时状态后清理空父文件夹"
+      },
       "0.2.7": {
         "en": "Consistent UI labels across all adapters",
         "de": "Einheitliche UI-Labels über alle Adapter",
@@ -80,19 +93,6 @@
         "pl": "Timery zarządzane przez adapter, CI na Windows/macOS, spójne klucze i18n w admin UI, pełna licencja MIT w README",
         "uk": "Таймери, керовані адаптером, CI на Windows/macOS, узгоджені ключі i18n в Admin UI, повна ліцензія MIT в README",
         "zh-cn": "适配器管理的定时器，Windows/macOS CI，一致的管理界面 i18n 键，README 中的完整 MIT 许可证"
-      },
-      "0.2.1": {
-        "en": "Robust error handling: API rate limit detection, connection error deduplication, poll throttling",
-        "de": "Robuste Fehlerbehandlung: Erkennung von API-Ratenlimits, Deduplizierung von Verbindungsfehlern, Polling-Drosselung",
-        "ru": "Надежная обработка ошибок: обнаружение ограничения скорости API, дедупликация ошибок соединения, регулирование опроса.",
-        "pt": "Tratamento robusto de erros: detecção de limite de taxa de API, desduplicação de erros de conexão, otimização de pesquisa",
-        "nl": "Robuuste foutafhandeling: detectie van API-snelheidslimieten, deduplicatie van verbindingsfouten, poll-throttling",
-        "fr": "Gestion robuste des erreurs : détection de limite de débit API, déduplication des erreurs de connexion, limitation des interrogations",
-        "it": "Gestione efficace degli errori: rilevamento del limite di velocità dell'API, deduplicazione degli errori di connessione, limitazione del poll",
-        "es": "Manejo sólido de errores: detección de límite de tasa de API, deduplicación de errores de conexión, limitación de encuestas",
-        "pl": "Solidna obsługa błędów: wykrywanie limitów szybkości interfejsu API, deduplikacja błędów połączenia, ograniczanie odpytywania",
-        "uk": "Надійна обробка помилок: виявлення обмеження швидкості API, дедуплікація помилок підключення, регулювання опитування",
-        "zh-cn": "强大的错误处理：API 速率限制检测、连接错误重复数据删除、轮询限制"
       }
     },
     "titleLang": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.parcelapp",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "ioBroker adapter for parcel.app — track packages from 300+ carriers",
   "author": {
     "name": "krobi",