iobroker.parcelapp 0.1.5 → 0.2.1

package/README.md

@@ -19,10 +19,10 @@ ioBroker adapter that connects to the [parcel.app](https://parcelapp.net) API an
 
 - **300+ carriers** — DHL, FedEx, UPS, Amazon, Hermes, GLS, DPD, and many more via parcel.app
 - **Per-package ioBroker states** — carrier, status, tracking number, delivery window, last event, last location
-- **Summary states** — active count, today count, combined delivery window, full JSON data
+- **Summary states** — active count, today count, combined delivery window
 - **Delivery time estimates** — today, tomorrow, in X days with combined time window
 - **Automatic polling** with configurable interval (5–60 minutes)
-- **Automatic cleanup** of delivered packages from the ioBroker object tree
+- **Configurable cleanup** — auto-remove delivered packages or keep them until deleted in parcel.app
 - **Add deliveries** via sendTo message from scripts or other adapters
 - **Admin UI** with connection test, polling settings, and status language selection
 - **Multilingual status labels** (German/English)
@@ -44,7 +44,7 @@ ioBroker adapter that connects to the [parcel.app](https://parcelapp.net) API an
 |--------|-------------|---------|
 | **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 |
-| **Filter Mode** | Active (current only) or Recent (includes completed) | Active |
+| **Auto-remove delivered** | Remove delivered packages from states automatically. When disabled, they stay until deleted in parcel.app. | Yes |
 | **Status Language** | Language for status labels (German/English) | German |
 
 ---
@@ -57,8 +57,7 @@ parcelapp.0.
 ├── summary.
 │   ├── activeCount              — Number of active deliveries
 │   ├── todayCount               — Number of deliveries expected today
-│   ├── deliveryWindow           — Combined delivery window for today
-│   └── json                     — All active deliveries as JSON
+│   └── deliveryWindow           — Combined delivery window for today
 └── deliveries.
     └── {packageId}.             — One device per package
         ├── carrier              — Carrier name (e.g. DHL Express)
@@ -86,7 +85,6 @@ parcelapp.0.
 ### No deliveries shown
 - The API returns cached data — new deliveries may take a few minutes to appear
 - Check if you have active deliveries in the parcel.app
-- Try changing the filter mode to "Recent" to see completed deliveries
 
 ### Rate limit
 - The parcel.app API allows 20 requests per hour
@@ -96,6 +94,14 @@ parcelapp.0.
 
 ## Changelog
 
+### 0.2.1 (2026-03-25)
+- Robust error handling: rate limit detection, connection error deduplication, poll throttling
+
+### 0.2.0 (2026-03-25)
+- Added option to keep delivered packages in states
+- Simplified admin UI to single page
+- Removed redundant summary.json state
+
 ### 0.1.5 (2026-03-24)
 - Added auto-merge config, weekly Dependabot schedule
 
@@ -110,10 +116,6 @@ parcelapp.0.
 
 ### 0.1.1 (2026-03-23)
 - Redesigned adapter logo
-- Fixed repochecker issues
-
-### 0.1.0 (2026-03-23)
-- Initial release
 
 Older changelog: [CHANGELOG.md](CHANGELOG.md)
 

package/admin/i18n/de/translations.json

@@ -1,27 +1,24 @@
 {
-  "tab_connection": "Verbindung",
-  "tab_settings": "Einstellungen",
-  "header_connection": "parcel.app API",
+  "aboutHeader": "Unterstütze diesen Adapter",
+  "aboutInfo": "Dieser Adapter ist kostenlos und Open Source. Wenn du ihn nützlich findest, unterstütze die Entwicklung gerne mit einer kleinen Spende.",
+  "aboutTab": "Info",
   "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.",
-  "label_filterMode": "Filtermodus",
-  "tooltip_filterMode": "Aktiv: nur laufende Lieferungen. Kürzlich: inklusive kürzlich zugestellter.",
-  "filterMode_active": "Nur aktive Lieferungen",
-  "filterMode_recent": "Kürzliche Lieferungen",
+  "donateKofi": "Unterstützen auf Ko-fi",
+  "donatePaypal": "Spenden via PayPal",
+  "header_connection": "parcel.app API",
+  "header_delivery": "Lieferungen",
   "header_display": "Anzeige",
+  "header_polling": "Abfrage",
+  "label_apiKey": "API-Schlüssel",
+  "label_autoRemoveDelivered": "Zugestellte Pakete automatisch entfernen",
   "label_language": "Status-Sprache",
-  "tooltip_language": "Sprache für Statusmeldungen (z.B. 'Unterwegs' vs 'In Transit')",
+  "label_pollInterval": "Abfrageintervall (Minuten)",
   "lang_de": "Deutsch",
   "lang_en": "Englisch",
-  "aboutTab": "Info",
-  "aboutHeader": "Unterstütze diesen Adapter",
-  "aboutInfo": "Dieser Adapter ist kostenlos und Open Source. Wenn du ihn nützlich findest, unterstütze die Entwicklung gerne mit einer kleinen Spende.",
-  "donateKofi": "Unterstützen auf Ko-fi",
-  "donatePaypal": "Spenden via PayPal"
+  "msg_connectionFailed": "Verbindung fehlgeschlagen!",
+  "msg_connectionOk": "Verbindung erfolgreich!",
+  "tooltip_autoRemoveDelivered": "Wenn aktiviert, werden zugestellte Pakete automatisch aus dem Objektbaum entfernt. Wenn deaktiviert, bleiben sie mit Status 'Zugestellt' bestehen, bis sie in parcel.app gelöscht werden.",
+  "tooltip_language": "Sprache für Statusmeldungen (z.B. 'Unterwegs' vs 'In Transit')",
+  "tooltip_pollInterval": "Wie oft Lieferupdates abgefragt werden (5-60 Minuten, Standard: 10). Rate-Limit: 20 Anfragen/Stunde."
 }

package/admin/i18n/en/translations.json

@@ -1,6 +1,4 @@
 {
-  "tab_connection": "Connection",
-  "tab_settings": "Settings",
   "header_connection": "parcel.app API",
   "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",
@@ -10,10 +8,9 @@
   "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.",
-  "label_filterMode": "Filter Mode",
-  "tooltip_filterMode": "Active: only current deliveries. Recent: includes recently completed.",
-  "filterMode_active": "Active deliveries only",
-  "filterMode_recent": "Recent deliveries",
+  "header_delivery": "Delivery",
+  "label_autoRemoveDelivered": "Automatically remove delivered packages",
+  "tooltip_autoRemoveDelivered": "When enabled, delivered packages are automatically removed from the state tree. When disabled, they remain with status 'Delivered' until deleted in parcel.app.",
   "header_display": "Display",
   "label_language": "Status Language",
   "tooltip_language": "Language for delivery status labels (e.g. 'In Transit' vs 'Unterwegs')",

package/admin/i18n/es/translations.json

@@ -1,27 +1,24 @@
 {
-  "tab_connection": "Conexión",
-  "tab_settings": "Configuración",
-  "header_connection": "parcel.app API",
+  "aboutHeader": "Apoya este adaptador",
+  "aboutInfo": "Este adaptador es gratuito y de código abierto. Si lo encuentras útil, considera apoyar el desarrollo con una pequeña donación.",
+  "aboutTab": "Acerca de",
   "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.",
-  "label_filterMode": "Modo de filtro",
-  "tooltip_filterMode": "Activo: solo entregas actuales. Reciente: incluye entregas recientemente completadas.",
-  "filterMode_active": "Solo entregas activas",
-  "filterMode_recent": "Entregas recientes",
+  "donateKofi": "Apoyar en Ko-fi",
+  "donatePaypal": "Donar vía PayPal",
+  "header_connection": "parcel.app API",
+  "header_delivery": "Entregas",
   "header_display": "Visualización",
+  "header_polling": "Consulta",
+  "label_apiKey": "Clave API",
+  "label_autoRemoveDelivered": "Eliminar automáticamente paquetes entregados",
   "label_language": "Idioma de estados",
-  "tooltip_language": "Idioma para las etiquetas de estado de entrega",
+  "label_pollInterval": "Intervalo de consulta (minutos)",
   "lang_de": "Alemán",
   "lang_en": "Inglés",
-  "aboutTab": "Acerca de",
-  "aboutHeader": "Apoya este adaptador",
-  "aboutInfo": "Este adaptador es gratuito y de código abierto. Si lo encuentras útil, considera apoyar el desarrollo con una pequeña donación.",
-  "donateKofi": "Apoyar en Ko-fi",
-  "donatePaypal": "Donar vía PayPal"
+  "msg_connectionFailed": "¡Error de conexión!",
+  "msg_connectionOk": "¡Conexión exitosa!",
+  "tooltip_autoRemoveDelivered": "Cuando está activado, los paquetes entregados se eliminan automáticamente del árbol de estados. Cuando está desactivado, permanecen con el estado 'Entregado' hasta ser eliminados en parcel.app.",
+  "tooltip_language": "Idioma para las etiquetas de estado de entrega",
+  "tooltip_pollInterval": "Con qué frecuencia obtener actualizaciones de entrega (5-60 minutos, predeterminado: 10). Límite: 20 solicitudes/hora."
 }

package/admin/i18n/fr/translations.json

@@ -1,27 +1,24 @@
 {
-  "tab_connection": "Connexion",
-  "tab_settings": "Paramètres",
-  "header_connection": "parcel.app API",
+  "aboutHeader": "Soutenez cet adaptateur",
+  "aboutInfo": "Cet adaptateur est gratuit et open source. Si vous le trouvez utile, pensez à soutenir son développement par un petit don.",
+  "aboutTab": "À propos",
   "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.",
-  "label_filterMode": "Mode de filtrage",
-  "tooltip_filterMode": "Actif : uniquement les livraisons en cours. Récent : inclut les livraisons récemment terminées.",
-  "filterMode_active": "Livraisons actives uniquement",
-  "filterMode_recent": "Livraisons récentes",
+  "donateKofi": "Soutenir sur Ko-fi",
+  "donatePaypal": "Faire un don via PayPal",
+  "header_connection": "parcel.app API",
+  "header_delivery": "Livraisons",
   "header_display": "Affichage",
+  "header_polling": "Interrogation",
+  "label_apiKey": "Clé API",
+  "label_autoRemoveDelivered": "Supprimer automatiquement les colis livrés",
   "label_language": "Langue des statuts",
-  "tooltip_language": "Langue pour les libellés de statut de livraison",
+  "label_pollInterval": "Intervalle d interrogation (minutes)",
   "lang_de": "Allemand",
   "lang_en": "Anglais",
-  "aboutTab": "À propos",
-  "aboutHeader": "Soutenez cet adaptateur",
-  "aboutInfo": "Cet adaptateur est gratuit et open source. Si vous le trouvez utile, pensez à soutenir son développement par un petit don.",
-  "donateKofi": "Soutenir sur Ko-fi",
-  "donatePaypal": "Faire un don via PayPal"
+  "msg_connectionFailed": "Échec de la connexion !",
+  "msg_connectionOk": "Connexion réussie !",
+  "tooltip_autoRemoveDelivered": "Lorsque activé, les colis livrés sont automatiquement supprimés de l'arborescence d'états. Lorsque désactivé, ils restent avec le statut 'Livré' jusqu'à leur suppression dans parcel.app.",
+  "tooltip_language": "Langue pour les libellés de statut de livraison",
+  "tooltip_pollInterval": "Fréquence de récupération des mises à jour de livraison (5-60 minutes, défaut : 10). Limite : 20 requêtes/heure."
 }

package/admin/i18n/it/translations.json

@@ -1,27 +1,24 @@
 {
-  "tab_connection": "Connessione",
-  "tab_settings": "Impostazioni",
-  "header_connection": "parcel.app API",
+  "aboutHeader": "Supporta questo adattatore",
+  "aboutInfo": "Questo adattatore è gratuito e open source. Se lo trovi utile, considera di supportare lo sviluppo con una piccola donazione.",
+  "aboutTab": "Info",
   "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.",
-  "label_filterMode": "Modalità filtro",
-  "tooltip_filterMode": "Attivo: solo consegne in corso. Recente: include consegne recentemente completate.",
-  "filterMode_active": "Solo consegne attive",
-  "filterMode_recent": "Consegne recenti",
+  "donateKofi": "Supporta su Ko-fi",
+  "donatePaypal": "Dona tramite PayPal",
+  "header_connection": "parcel.app API",
+  "header_delivery": "Consegne",
   "header_display": "Visualizzazione",
+  "header_polling": "Polling",
+  "label_apiKey": "Chiave API",
+  "label_autoRemoveDelivered": "Rimuovi automaticamente i pacchi consegnati",
   "label_language": "Lingua degli stati",
-  "tooltip_language": "Lingua per le etichette di stato della consegna",
+  "label_pollInterval": "Intervallo di polling (minuti)",
   "lang_de": "Tedesco",
   "lang_en": "Inglese",
-  "aboutTab": "Info",
-  "aboutHeader": "Supporta questo adattatore",
-  "aboutInfo": "Questo adattatore è gratuito e open source. Se lo trovi utile, considera di supportare lo sviluppo con una piccola donazione.",
-  "donateKofi": "Supporta su Ko-fi",
-  "donatePaypal": "Dona tramite PayPal"
+  "msg_connectionFailed": "Connessione fallita!",
+  "msg_connectionOk": "Connessione riuscita!",
+  "tooltip_autoRemoveDelivered": "Se attivato, i pacchi consegnati vengono automaticamente rimossi dall'albero degli stati. Se disattivato, rimangono con lo stato 'Consegnato' fino alla cancellazione in parcel.app.",
+  "tooltip_language": "Lingua per le etichette di stato della consegna",
+  "tooltip_pollInterval": "Frequenza di aggiornamento delle consegne (5-60 minuti, predefinito: 10). Limite: 20 richieste/ora."
 }

package/admin/i18n/nl/translations.json

@@ -1,27 +1,24 @@
 {
-  "tab_connection": "Verbinding",
-  "tab_settings": "Instellingen",
-  "header_connection": "parcel.app API",
+  "aboutHeader": "Steun deze adapter",
+  "aboutInfo": "Deze adapter is gratis en open source. Als je hem nuttig vindt, overweeg dan de ontwikkeling te steunen met een kleine donatie.",
+  "aboutTab": "Over",
   "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.",
-  "label_filterMode": "Filtermodus",
-  "tooltip_filterMode": "Actief: alleen huidige bezorgingen. Recent: inclusief recent afgeleverde.",
-  "filterMode_active": "Alleen actieve bezorgingen",
-  "filterMode_recent": "Recente bezorgingen",
+  "donateKofi": "Steunen op Ko-fi",
+  "donatePaypal": "Doneren via PayPal",
+  "header_connection": "parcel.app API",
+  "header_delivery": "Leveringen",
   "header_display": "Weergave",
+  "header_polling": "Polling",
+  "label_apiKey": "API-sleutel",
+  "label_autoRemoveDelivered": "Afgeleverde pakketten automatisch verwijderen",
   "label_language": "Statustaal",
-  "tooltip_language": "Taal voor bezorgingsstatussen",
+  "label_pollInterval": "Polling-interval (minuten)",
   "lang_de": "Duits",
   "lang_en": "Engels",
-  "aboutTab": "Over",
-  "aboutHeader": "Steun deze adapter",
-  "aboutInfo": "Deze adapter is gratis en open source. Als je hem nuttig vindt, overweeg dan de ontwikkeling te steunen met een kleine donatie.",
-  "donateKofi": "Steunen op Ko-fi",
-  "donatePaypal": "Doneren via PayPal"
+  "msg_connectionFailed": "Verbinding mislukt!",
+  "msg_connectionOk": "Verbinding succesvol!",
+  "tooltip_autoRemoveDelivered": "Indien ingeschakeld worden afgeleverde pakketten automatisch uit de objectboom verwijderd. Indien uitgeschakeld blijven ze met status 'Afgeleverd' bestaan tot ze in parcel.app worden verwijderd.",
+  "tooltip_language": "Taal voor bezorgingsstatussen",
+  "tooltip_pollInterval": "Hoe vaak bezorgingsupdates ophalen (5-60 minuten, standaard: 10). Limiet: 20 verzoeken/uur."
 }

package/admin/i18n/pl/translations.json

@@ -1,27 +1,24 @@
 {
-  "tab_connection": "Połączenie",
-  "tab_settings": "Ustawienia",
-  "header_connection": "parcel.app API",
+  "aboutHeader": "Wesprzyj ten adapter",
+  "aboutInfo": "Ten adapter jest darmowy i open source. Jeśli uważasz go za przydatny, rozważ wsparcie rozwoju niewielką darowizną.",
+  "aboutTab": "O programie",
   "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ę.",
-  "label_filterMode": "Tryb filtrowania",
-  "tooltip_filterMode": "Aktywne: tylko bieżące dostawy. Ostatnie: w tym niedawno ukończone.",
-  "filterMode_active": "Tylko aktywne dostawy",
-  "filterMode_recent": "Ostatnie dostawy",
+  "donateKofi": "Wesprzyj na Ko-fi",
+  "donatePaypal": "Przekaż darowiznę przez PayPal",
+  "header_connection": "parcel.app API",
+  "header_delivery": "Dostawy",
   "header_display": "Wyświetlanie",
+  "header_polling": "Odpytywanie",
+  "label_apiKey": "Klucz API",
+  "label_autoRemoveDelivered": "Automatycznie usuwaj dostarczone przesyłki",
   "label_language": "Język statusów",
-  "tooltip_language": "Język dla etykiet statusu dostawy",
+  "label_pollInterval": "Interwał odpytywania (minuty)",
   "lang_de": "Niemiecki",
   "lang_en": "Angielski",
-  "aboutTab": "O programie",
-  "aboutHeader": "Wesprzyj ten adapter",
-  "aboutInfo": "Ten adapter jest darmowy i open source. Jeśli uważasz go za przydatny, rozważ wsparcie rozwoju niewielką darowizną.",
-  "donateKofi": "Wesprzyj na Ko-fi",
-  "donatePaypal": "Przekaż darowiznę przez PayPal"
+  "msg_connectionFailed": "Połączenie nieudane!",
+  "msg_connectionOk": "Połączenie udane!",
+  "tooltip_autoRemoveDelivered": "Po włączeniu dostarczone przesyłki są automatycznie usuwane z drzewa stanów. Po wyłączeniu pozostają ze statusem 'Dostarczono' do usunięcia w parcel.app.",
+  "tooltip_language": "Język dla etykiet statusu dostawy",
+  "tooltip_pollInterval": "Jak często pobierać aktualizacje dostaw (5-60 minut, domyślnie: 10). Limit: 20 zapytań/godzinę."
 }

package/admin/i18n/pt/translations.json

@@ -1,27 +1,24 @@
 {
-  "tab_connection": "Conexão",
-  "tab_settings": "Configurações",
-  "header_connection": "parcel.app API",
+  "aboutHeader": "Apoie este adaptador",
+  "aboutInfo": "Este adaptador é gratuito e de código aberto. Se você o achar útil, considere apoiar o desenvolvimento com uma pequena doação.",
+  "aboutTab": "Sobre",
   "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.",
-  "label_filterMode": "Modo de filtro",
-  "tooltip_filterMode": "Ativo: apenas entregas atuais. Recente: inclui entregas recentemente concluídas.",
-  "filterMode_active": "Apenas entregas ativas",
-  "filterMode_recent": "Entregas recentes",
+  "donateKofi": "Apoiar no Ko-fi",
+  "donatePaypal": "Doar via PayPal",
+  "header_connection": "parcel.app API",
+  "header_delivery": "Entregas",
   "header_display": "Exibição",
+  "header_polling": "Consulta",
+  "label_apiKey": "Chave API",
+  "label_autoRemoveDelivered": "Remover automaticamente pacotes entregues",
   "label_language": "Idioma do status",
-  "tooltip_language": "Idioma para os rótulos de status de entrega",
+  "label_pollInterval": "Intervalo de consulta (minutos)",
   "lang_de": "Alemão",
   "lang_en": "Inglês",
-  "aboutTab": "Sobre",
-  "aboutHeader": "Apoie este adaptador",
-  "aboutInfo": "Este adaptador é gratuito e de código aberto. Se você o achar útil, considere apoiar o desenvolvimento com uma pequena doação.",
-  "donateKofi": "Apoiar no Ko-fi",
-  "donatePaypal": "Doar via PayPal"
+  "msg_connectionFailed": "Falha na conexão!",
+  "msg_connectionOk": "Conexão bem-sucedida!",
+  "tooltip_autoRemoveDelivered": "Quando ativado, os pacotes entregues são automaticamente removidos da árvore de estados. Quando desativado, permanecem com o estado 'Entregue' até serem eliminados no parcel.app.",
+  "tooltip_language": "Idioma para os rótulos de status de entrega",
+  "tooltip_pollInterval": "Com que frequência buscar atualizações de entrega (5-60 minutos, padrão: 10). Limite: 20 solicitações/hora."
 }

package/admin/i18n/ru/translations.json

@@ -1,27 +1,24 @@
 {
-  "tab_connection": "Соединение",
-  "tab_settings": "Настройки",
-  "header_connection": "parcel.app API",
+  "aboutHeader": "Поддержите этот адаптер",
+  "aboutInfo": "Этот адаптер бесплатный и с открытым исходным кодом. Если он вам полезен, поддержите разработку небольшим пожертвованием.",
+  "aboutTab": "О программе",
   "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 запросов/час.",
-  "label_filterMode": "Режим фильтра",
-  "tooltip_filterMode": "Активные: только текущие доставки. Недавние: включая недавно доставленные.",
-  "filterMode_active": "Только активные доставки",
-  "filterMode_recent": "Недавние доставки",
+  "donateKofi": "Поддержать на Ko-fi",
+  "donatePaypal": "Пожертвовать через PayPal",
+  "header_connection": "parcel.app API",
+  "header_delivery": "Доставки",
   "header_display": "Отображение",
+  "header_polling": "Опрос",
+  "label_apiKey": "API-ключ",
+  "label_autoRemoveDelivered": "Автоматически удалять доставленные посылки",
   "label_language": "Язык статусов",
-  "tooltip_language": "Язык для статусов доставки",
+  "label_pollInterval": "Интервал опроса (минуты)",
   "lang_de": "Немецкий",
   "lang_en": "Английский",
-  "aboutTab": "О программе",
-  "aboutHeader": "Поддержите этот адаптер",
-  "aboutInfo": "Этот адаптер бесплатный и с открытым исходным кодом. Если он вам полезен, поддержите разработку небольшим пожертвованием.",
-  "donateKofi": "Поддержать на Ko-fi",
-  "donatePaypal": "Пожертвовать через PayPal"
+  "msg_connectionFailed": "Ошибка соединения!",
+  "msg_connectionOk": "Соединение успешно!",
+  "tooltip_autoRemoveDelivered": "Если включено, доставленные посылки автоматически удаляются из дерева состояний. Если выключено, они остаются со статусом 'Доставлено' до удаления в parcel.app.",
+  "tooltip_language": "Язык для статусов доставки",
+  "tooltip_pollInterval": "Как часто получать обновления доставки (5-60 минут, по умолчанию: 10). Лимит: 20 запросов/час."
 }

package/admin/i18n/uk/translations.json

@@ -1,27 +1,24 @@
 {
-  "tab_connection": "З'єднання",
-  "tab_settings": "Налаштування",
-  "header_connection": "parcel.app API",
+  "aboutHeader": "Підтримайте цей адаптер",
+  "aboutInfo": "Цей адаптер безкоштовний та з відкритим кодом. Якщо він вам корисний, підтримайте розробку невеликою пожертвою.",
+  "aboutTab": "Про програму",
   "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 запитів/годину.",
-  "label_filterMode": "Режим фільтрування",
-  "tooltip_filterMode": "Активні: лише поточні доставки. Нещодавні: включно з нещодавно завершеними.",
-  "filterMode_active": "Лише активні доставки",
-  "filterMode_recent": "Нещодавні доставки",
+  "donateKofi": "Підтримати на Ko-fi",
+  "donatePaypal": "Пожертвувати через PayPal",
+  "header_connection": "parcel.app API",
+  "header_delivery": "Доставки",
   "header_display": "Відображення",
+  "header_polling": "Опитування",
+  "label_apiKey": "API-ключ",
+  "label_autoRemoveDelivered": "Автоматично видаляти доставлені посилки",
   "label_language": "Мова статусів",
-  "tooltip_language": "Мова для міток статусу доставки",
+  "label_pollInterval": "Інтервал опитування (хвилини)",
   "lang_de": "Німецька",
   "lang_en": "Англійська",
-  "aboutTab": "Про програму",
-  "aboutHeader": "Підтримайте цей адаптер",
-  "aboutInfo": "Цей адаптер безкоштовний та з відкритим кодом. Якщо він вам корисний, підтримайте розробку невеликою пожертвою.",
-  "donateKofi": "Підтримати на Ko-fi",
-  "donatePaypal": "Пожертвувати через PayPal"
+  "msg_connectionFailed": "Помилка з'єднання!",
+  "msg_connectionOk": "З'єднання успішне!",
+  "tooltip_autoRemoveDelivered": "Якщо увімкнено, доставлені посилки автоматично видаляються з дерева станів. Якщо вимкнено, вони залишаються зі статусом 'Доставлено' до видалення в parcel.app.",
+  "tooltip_language": "Мова для міток статусу доставки",
+  "tooltip_pollInterval": "Як часто отримувати оновлення доставки (5-60 хвилин, за замовчуванням: 10). Ліміт: 20 запитів/годину."
 }

package/admin/i18n/zh-cn/translations.json

@@ -1,27 +1,24 @@
 {
-  "tab_connection": "连接",
-  "tab_settings": "设置",
-  "header_connection": "parcel.app API",
+  "aboutHeader": "支持此适配器",
+  "aboutInfo": "此适配器免费且开源。如果您觉得有用，请考虑通过小额捐赠支持开发。",
+  "aboutTab": "关于",
   "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次请求/小时。",
-  "label_filterMode": "过滤模式",
-  "tooltip_filterMode": "活跃：仅当前快递。最近：包括最近完成的。",
-  "filterMode_active": "仅活跃快递",
-  "filterMode_recent": "最近的快递",
+  "donateKofi": "在 Ko-fi 上支持",
+  "donatePaypal": "通过 PayPal 捐赠",
+  "header_connection": "parcel.app API",
+  "header_delivery": "配送",
   "header_display": "显示",
+  "header_polling": "轮询",
+  "label_apiKey": "API 密钥",
+  "label_autoRemoveDelivered": "自动移除已送达的包裹",
   "label_language": "状态语言",
-  "tooltip_language": "快递状态标签的语言",
+  "label_pollInterval": "轮询间隔（分钟）",
   "lang_de": "德语",
   "lang_en": "英语",
-  "aboutTab": "关于",
-  "aboutHeader": "支持此适配器",
-  "aboutInfo": "此适配器免费且开源。如果您觉得有用，请考虑通过小额捐赠支持开发。",
-  "donateKofi": "在 Ko-fi 上支持",
-  "donatePaypal": "通过 PayPal 捐赠"
+  "msg_connectionFailed": "连接失败！",
+  "msg_connectionOk": "连接成功！",
+  "tooltip_autoRemoveDelivered": "启用后，已送达的包裹会自动从状态树中移除。禁用后，它们将保持'已送达'状态，直到在 parcel.app 中删除。",
+  "tooltip_language": "快递状态标签的语言",
+  "tooltip_pollInterval": "多久获取一次快递更新（5-60分钟，默认：10）。速率限制：20次请求/小时。"
 }

package/admin/jsonConfig.json

@@ -1,131 +1,116 @@
 {
   "i18n": true,
-  "type": "tabs",
+  "type": "panel",
   "items": {
-    "connectionTab": {
-      "type": "panel",
-      "label": "tab_connection",
-      "items": {
-        "connectionHeader": {
-          "type": "header",
-          "text": "header_connection",
-          "size": 4
-        },
-        "apiKeyInfo": {
-          "type": "staticText",
-          "text": "apiKeyInfo",
-          "xs": 12, "sm": 12, "md": 12, "lg": 12, "xl": 12,
-          "style": {
-            "fontSize": 14,
-            "color": "#666",
-            "marginBottom": 16
-          }
-        },
-        "apiKey": {
-          "type": "password",
-          "label": "label_apiKey",
-          "xs": 12, "sm": 12, "md": 8, "lg": 8, "xl": 8
-        },
-        "checkConnection": {
-          "newLine": true,
-          "type": "sendTo",
-          "label": "btn_checkConnection",
-          "command": "checkConnection",
-          "jsonData": "{\"apiKey\": \"${data.apiKey}\"}",
-          "result": {
-            "okText": "msg_connectionOk",
-            "errorText": "msg_connectionFailed"
-          },
-          "xs": 12, "sm": 12, "md": 4, "lg": 4, "xl": 4
-        }
-      }
+    "connectionHeader": {
+      "type": "header",
+      "text": "header_connection",
+      "size": 4
     },
-    "settingsTab": {
-      "type": "panel",
-      "label": "tab_settings",
-      "items": {
-        "pollingHeader": {
-          "type": "header",
-          "text": "header_polling",
-          "size": 5
-        },
-        "pollInterval": {
-          "type": "number",
-          "label": "label_pollInterval",
-          "tooltip": "tooltip_pollInterval",
-          "min": 5,
-          "max": 60,
-          "default": 10,
-          "xs": 12, "sm": 12, "md": 6, "lg": 6, "xl": 6
-        },
-        "filterMode": {
-          "type": "select",
-          "label": "label_filterMode",
-          "tooltip": "tooltip_filterMode",
-          "default": "active",
-          "options": [
-            { "label": "filterMode_active", "value": "active" },
-            { "label": "filterMode_recent", "value": "recent" }
-          ],
-          "xs": 12, "sm": 12, "md": 6, "lg": 6, "xl": 6
-        },
-        "displayHeader": {
-          "newLine": true,
-          "type": "header",
-          "text": "header_display",
-          "size": 5
-        },
-        "language": {
-          "type": "select",
-          "label": "label_language",
-          "tooltip": "tooltip_language",
-          "default": "de",
-          "options": [
-            { "label": "lang_de", "value": "de" },
-            { "label": "lang_en", "value": "en" }
-          ],
-          "xs": 12, "sm": 12, "md": 6, "lg": 6, "xl": 6
-        }
+    "apiKeyInfo": {
+      "type": "staticText",
+      "text": "apiKeyInfo",
+      "xs": 12, "sm": 12, "md": 12, "lg": 12, "xl": 12,
+      "style": {
+        "fontSize": 14,
+        "color": "#666",
+        "marginBottom": 16
       }
     },
-    "aboutTab": {
-      "type": "panel",
-      "label": "aboutTab",
-      "items": {
-        "aboutHeader": {
-          "type": "header",
-          "text": "aboutHeader",
-          "size": 4
-        },
-        "aboutInfo": {
-          "type": "staticText",
-          "text": "aboutInfo",
-          "xs": 12, "sm": 12, "md": 12, "lg": 12, "xl": 12,
-          "style": {
-            "fontSize": 14,
-            "marginBottom": 16
-          }
-        },
-        "_kofiLink": {
-          "type": "staticLink",
-          "href": "https://ko-fi.com/krobipd",
-          "label": "donateKofi",
-          "button": true,
-          "variant": "outlined",
-          "color": "primary",
-          "icon": "favorite",
-          "xs": 12, "sm": 6, "md": 4, "lg": 4, "xl": 4
-        },
-        "_paypalLink": {
-          "type": "staticLink",
-          "href": "https://paypal.me/krobipd",
-          "label": "donatePaypal",
-          "button": true,
-          "variant": "outlined",
-          "color": "primary",
-          "xs": 12, "sm": 6, "md": 4, "lg": 4, "xl": 4
-        }
+    "apiKey": {
+      "type": "password",
+      "label": "label_apiKey",
+      "xs": 12, "sm": 12, "md": 8, "lg": 8, "xl": 8
+    },
+    "checkConnection": {
+      "newLine": true,
+      "type": "sendTo",
+      "label": "btn_checkConnection",
+      "command": "checkConnection",
+      "jsonData": "{\"apiKey\": \"${data.apiKey}\"}",
+      "result": {
+        "okText": "msg_connectionOk",
+        "errorText": "msg_connectionFailed"
+      },
+      "xs": 12, "sm": 12, "md": 4, "lg": 4, "xl": 4
+    },
+    "pollingHeader": {
+      "newLine": true,
+      "type": "header",
+      "text": "header_polling",
+      "size": 5
+    },
+    "pollInterval": {
+      "type": "number",
+      "label": "label_pollInterval",
+      "tooltip": "tooltip_pollInterval",
+      "min": 5,
+      "max": 60,
+      "default": 10,
+      "xs": 12, "sm": 12, "md": 6, "lg": 6, "xl": 6
+    },
+    "deliveryHeader": {
+      "newLine": true,
+      "type": "header",
+      "text": "header_delivery",
+      "size": 5
+    },
+    "autoRemoveDelivered": {
+      "type": "checkbox",
+      "label": "label_autoRemoveDelivered",
+      "tooltip": "tooltip_autoRemoveDelivered",
+      "default": true,
+      "xs": 12, "sm": 12, "md": 12, "lg": 12, "xl": 12
+    },
+    "displayHeader": {
+      "newLine": true,
+      "type": "header",
+      "text": "header_display",
+      "size": 5
+    },
+    "language": {
+      "type": "select",
+      "label": "label_language",
+      "tooltip": "tooltip_language",
+      "default": "de",
+      "options": [
+        { "label": "lang_de", "value": "de" },
+        { "label": "lang_en", "value": "en" }
+      ],
+      "xs": 12, "sm": 12, "md": 6, "lg": 6, "xl": 6
+    },
+    "aboutHeader": {
+      "newLine": true,
+      "type": "header",
+      "text": "aboutHeader",
+      "size": 5
+    },
+    "aboutInfo": {
+      "type": "staticText",
+      "text": "aboutInfo",
+      "xs": 12, "sm": 12, "md": 12, "lg": 12, "xl": 12,
+      "style": {
+        "fontSize": 14,
+        "marginBottom": 16
       }
+    },
+    "_kofiLink": {
+      "type": "staticLink",
+      "href": "https://ko-fi.com/krobipd",
+      "label": "donateKofi",
+      "button": true,
+      "variant": "outlined",
+      "color": "primary",
+      "xs": 12, "sm": 6, "md": 4, "lg": 4, "xl": 4
+    },
+    "_paypalLink": {
+      "type": "staticLink",
+      "href": "https://paypal.me/krobipd",
+      "label": "donatePaypal",
+      "button": true,
+      "variant": "outlined",
+      "color": "primary",
+      "xs": 12, "sm": 6, "md": 4, "lg": 4, "xl": 4
     }
   }
 }

package/build/lib/parcel-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parcel-client.d.ts","sourceRoot":"","sources":["../../src/lib/parcel-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACX,MAAM,SAAS,CAAC;AAKjB,yCAAyC;AACzC,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAA2B;IAE/C,2CAA2C;gBAC/B,MAAM,EAAE,MAAM;IAI1B;;;;OAIG;IACG,aAAa,CACjB,UAAU,GAAE,QAAQ,GAAG,QAAmB,GACzC,OAAO,CAAC,cAAc,EAAE,CAAC;IAqB5B;;;;OAIG;IACG,WAAW,CACf,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAS/B,kDAAkD;IAC5C,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC;IAkB5C;;;;OAIG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1D,mCAAmC;IAC7B,cAAc,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAatE;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO;CAqEhB"}
+{"version":3,"file":"parcel-client.d.ts","sourceRoot":"","sources":["../../src/lib/parcel-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACX,MAAM,SAAS,CAAC;AAKjB,yCAAyC;AACzC,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAA2B;IAE/C,2CAA2C;gBAC/B,MAAM,EAAE,MAAM;IAI1B;;;;OAIG;IACG,aAAa,CACjB,UAAU,GAAE,QAAQ,GAAG,QAAmB,GACzC,OAAO,CAAC,cAAc,EAAE,CAAC;IAqB5B;;;;OAIG;IACG,WAAW,CACf,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAS/B,kDAAkD;IAC5C,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC;IAkB5C;;;;OAIG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1D,mCAAmC;IAC7B,cAAc,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAatE;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO;CAiFhB"}

package/build/lib/parcel-client.js

@@ -137,6 +137,15 @@ class ParcelClient {
                     const raw = Buffer.concat(chunks).toString("utf-8");
                     if (res.statusCode &&
                         (res.statusCode < 200 || res.statusCode >= 300)) {
+                        if (res.statusCode === 429) {
+                            const retryAfter = parseInt(res.headers["retry-after"] || "", 10);
+                            const err = new Error("Rate limit exceeded");
+                            err.code = "RATE_LIMITED";
+                            // Use Retry-After header or default to 5 minutes
+                            err.retryAfterSeconds = retryAfter > 0 ? retryAfter : 5 * 60;
+                            reject(err);
+                            return;
+                        }
                         const err = new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`);
                         err.code =
                             res.statusCode === 401 || res.statusCode === 403

package/build/lib/state-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../src/lib/state-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAqB9C,oDAAoD;AACpD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAkB;IAEjC,mDAAmD;gBACvC,OAAO,EAAE,eAAe;IAIpC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAU9B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM;IAQ3C;;;;;OAKG;IACG,cAAc,CAClB,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAiGhB;;;;OAIG;IACG,aAAa,CAAC,gBAAgB,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CtE;;;;OAIG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3D;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IA2B/B;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAiDjC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAevB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAkC/B;;;;;;;;OAQG;YACW,YAAY;CAc3B"}
+{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../src/lib/state-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAqB9C,oDAAoD;AACpD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAkB;IAEjC,mDAAmD;gBACvC,OAAO,EAAE,eAAe;IAIpC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAU9B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM;IAQ3C;;;;;OAKG;IACG,cAAc,CAClB,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAiGhB;;;;OAIG;IACG,aAAa,CAAC,gBAAgB,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCtE;;;;OAIG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3D;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IA2B/B;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAiDjC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAevB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAkC/B;;;;;;;;OAQG;YACW,YAAY;CAc3B"}

package/build/lib/state-manager.js

@@ -102,7 +102,6 @@ class StateManager {
             this.createAndSet("summary.activeCount", "Active Deliveries", "number", "value", activeDeliveries.length),
             this.createAndSet("summary.todayCount", "Deliveries Today", "number", "value", todayDeliveries.length),
             this.createAndSet("summary.deliveryWindow", "Combined Delivery Window", "string", "text", this.calculateCombinedWindow(todayDeliveries)),
-            this.createAndSet("summary.json", "All Deliveries (JSON)", "string", "json", JSON.stringify(activeDeliveries)),
         ]);
     }
     /**

package/build/lib/types.d.ts

@@ -76,10 +76,10 @@ declare global {
             apiKey: string;
             /** Polling interval in minutes */
             pollInterval: number;
-            /** Filter mode for deliveries */
-            filterMode: "active" | "recent";
             /** Language for status labels */
             language: "de" | "en";
+            /** Automatically remove delivered packages from states */
+            autoRemoveDelivered: boolean;
         }
     }
 }

package/build/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qCAAqC;IACrC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,gCAAgC;AAChC,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUnD,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUnD,CAAC;AAGF,OAAO,CAAC,MAAM,CAAC;IAEb,UAAU,QAAQ,CAAC;QACjB,UAAU,aAAa;YACrB,yBAAyB;YACzB,MAAM,EAAE,MAAM,CAAC;YACf,kCAAkC;YAClC,YAAY,EAAE,MAAM,CAAC;YACrB,iCAAiC;YACjC,UAAU,EAAE,QAAQ,GAAG,QAAQ,CAAC;YAChC,iCAAiC;YACjC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;SACvB;KACF;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qCAAqC;IACrC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,gCAAgC;AAChC,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUnD,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUnD,CAAC;AAGF,OAAO,CAAC,MAAM,CAAC;IAEb,UAAU,QAAQ,CAAC;QACjB,UAAU,aAAa;YACrB,yBAAyB;YACzB,MAAM,EAAE,MAAM,CAAC;YACf,kCAAkC;YAClC,YAAY,EAAE,MAAM,CAAC;YACrB,iCAAiC;YACjC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;YACtB,0DAA0D;YAC1D,mBAAmB,EAAE,OAAO,CAAC;SAC9B;KACF;CACF"}

package/build/main.js

@@ -40,12 +40,16 @@ require("./lib/types");
 const MIN_POLL_INTERVAL = 5;
 const MAX_POLL_INTERVAL = 60;
 const DEFAULT_POLL_INTERVAL = 10;
+const MIN_POLL_GAP_MS = 60_000; // Minimum 60s between polls
 /** ioBroker adapter for parcel.app package tracking */
 class ParcelappAdapter extends utils.Adapter {
     client = null;
     stateManager = null;
     pollTimer = null;
     isPolling = false;
+    lastPollTime = 0;
+    rateLimitedUntil = 0;
+    lastErrorCode = "";
     /** @param options Adapter options */
     constructor(options = {}) {
         super({
@@ -67,6 +71,8 @@ class ParcelappAdapter extends utils.Adapter {
         // Initialize
         this.client = new parcel_client_1.ParcelClient(apiKey.trim());
         this.stateManager = new state_manager_1.StateManager(this);
+        // Cleanup obsolete states
+        await this.cleanupObsoleteStates();
         // Initial poll
         await this.poll();
         // Set up recurring poll
@@ -124,37 +130,116 @@ class ParcelappAdapter extends utils.Adapter {
                 this.sendTo(obj.from, obj.command, { error: "Unknown command" }, obj.callback);
         }
     }
+    async cleanupObsoleteStates() {
+        const obsoleteStates = [
+            "summary.json", // removed in 0.2.0
+        ];
+        for (const stateId of obsoleteStates) {
+            const obj = await this.getObjectAsync(stateId);
+            if (obj) {
+                await this.delObjectAsync(stateId);
+                this.log.debug(`Removed obsolete state: ${stateId}`);
+            }
+        }
+    }
+    /**
+     * Classify an error for deduplication and log-level decisions.
+     *
+     * @param error The error to classify
+     */
+    classifyError(error) {
+        if (error.code === "RATE_LIMITED") {
+            return "RATE_LIMITED";
+        }
+        if (error.code === "INVALID_API_KEY") {
+            return "INVALID_API_KEY";
+        }
+        // Network errors: DNS, connection refused, no internet
+        if (error.code === "ENOTFOUND" ||
+            error.code === "ECONNREFUSED" ||
+            error.code === "ECONNRESET" ||
+            error.code === "ENETUNREACH" ||
+            error.code === "EAI_AGAIN") {
+            return "NETWORK";
+        }
+        if (error.message.includes("timeout") || error.code === "ETIMEDOUT") {
+            return "TIMEOUT";
+        }
+        return error.code || "UNKNOWN";
+    }
     async poll() {
         if (this.isPolling || !this.client || !this.stateManager) {
             return;
         }
+        const now = Date.now();
+        // Skip if rate limited
+        if (now < this.rateLimitedUntil) {
+            const waitMin = Math.ceil((this.rateLimitedUntil - now) / 60_000);
+            this.log.debug(`Skipping poll — rate limited for ${waitMin} more minute(s)`);
+            return;
+        }
+        // Throttle: minimum gap between polls
+        if (now - this.lastPollTime < MIN_POLL_GAP_MS) {
+            this.log.debug("Skipping poll — too soon after last poll");
+            return;
+        }
         this.isPolling = true;
+        this.lastPollTime = now;
         try {
-            const filterMode = this.config.filterMode || "active";
-            const deliveries = await this.client.getDeliveries(filterMode);
+            // When keeping delivered packages, use "recent" to get them from API
+            const autoRemove = this.config.autoRemoveDelivered !== false;
+            const deliveries = await this.client.getDeliveries(autoRemove ? "active" : "recent");
+            // Reset error state on success
+            this.rateLimitedUntil = 0;
+            if (this.lastErrorCode) {
+                this.log.info("Connection restored");
+                this.lastErrorCode = "";
+            }
             await this.setStateAsync("info.connection", { val: true, ack: true });
-            // Filter active deliveries (exclude delivered)
-            const activeDeliveries = deliveries.filter((d) => parseInt(d.status_code, 10) !== 0);
+            // Filter deliveries based on auto-remove setting
+            const visibleDeliveries = autoRemove
+                ? deliveries.filter((d) => parseInt(d.status_code, 10) !== 0)
+                : deliveries;
             // Update each delivery
             const activeIds = [];
-            for (const delivery of activeDeliveries) {
+            for (const delivery of visibleDeliveries) {
                 const carrierName = await this.client.getCarrierName(delivery.carrier_code);
                 await this.stateManager.updateDelivery(delivery, carrierName);
                 activeIds.push(this.stateManager.packageId(delivery));
             }
             // Cleanup stale deliveries
             await this.stateManager.cleanupDeliveries(activeIds);
-            // Update summary (already filtered — no re-filtering needed)
-            await this.stateManager.updateSummary(activeDeliveries);
-            this.log.debug(`Polled ${activeDeliveries.length} active deliveries`);
+            // Update summary
+            const summaryDeliveries = autoRemove
+                ? visibleDeliveries
+                : deliveries.filter((d) => parseInt(d.status_code, 10) !== 0);
+            await this.stateManager.updateSummary(summaryDeliveries);
+            this.log.debug(`Polled ${visibleDeliveries.length} deliveries (${summaryDeliveries.length} active)`);
         }
         catch (err) {
             const error = err;
-            if (error.code === "INVALID_API_KEY") {
+            // Classify the error
+            const errorCode = this.classifyError(error);
+            const isRepeat = errorCode === this.lastErrorCode;
+            this.lastErrorCode = errorCode;
+            if (error.code === "RATE_LIMITED") {
+                const cooldownSec = error.retryAfterSeconds || 5 * 60;
+                this.rateLimitedUntil = Date.now() + cooldownSec * 1000;
+                this.log.warn(`Rate limit hit — pausing API requests for ${Math.ceil(cooldownSec / 60)} minute(s)`);
+            }
+            else if (error.code === "INVALID_API_KEY") {
+                // Always log — user must fix config
                 this.log.error("Invalid API key — please check your parcel.app API key");
             }
-            else if (error.message.includes("timeout")) {
-                this.log.error(`API request timeout: ${error.message}`);
+            else if (isRepeat) {
+                // Same error as last time — don't spam the log
+                this.log.debug(`Poll failed (ongoing): ${error.message}`);
+            }
+            else if (errorCode === "NETWORK") {
+                this.log.warn(`Cannot reach parcel.app API — will keep retrying`);
+            }
+            else if (errorCode === "TIMEOUT") {
+                this.log.warn(`API request timeout — will retry next cycle`);
             }
             else {
                 this.log.error(`Poll failed: ${error.message}`);

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "parcelapp",
-    "version": "0.1.5",
+    "version": "0.2.1",
     "news": {
+      "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 速率限制检测、连接错误重复数据删除、轮询限制"
+      },
+      "0.2.0": {
+        "en": "Added option to keep delivered packages, simplified admin UI, removed summary.json state",
+        "de": "Option zum Beibehalten gelieferter Pakete hinzugefügt, Admin-Benutzeroberfläche vereinfacht, Status „summary.json“ entfernt",
+        "ru": "Добавлена ​​опция сохранения доставленных пакетов, упрощен пользовательский интерфейс администратора, удалено состояние summary.json.",
+        "pt": "Adicionada opção para manter pacotes entregues, UI de administração simplificada, estado summary.json removido",
+        "nl": "Optie toegevoegd om afgeleverde pakketten te behouden, vereenvoudigde beheerdersinterface, verwijderde summary.json-status",
+        "fr": "Ajout d'une option pour conserver les packages livrés, interface utilisateur d'administration simplifiée, suppression de l'état summary.json",
+        "it": "Aggiunta opzione per mantenere i pacchetti consegnati, interfaccia utente di amministrazione semplificata, stato summary.json rimosso",
+        "es": "Opción agregada para conservar los paquetes entregados, interfaz de usuario de administración simplificada, estado de resumen.json eliminado",
+        "pl": "Dodano opcję przechowywania dostarczonych paczek, uproszczony interfejs administratora, usunięto stan podsumowania.json",
+        "uk": "Додано параметр збереження доставлених пакетів, спрощений інтерфейс адміністратора, видалено стан summary.json",
+        "zh-cn": "添加了保留已交付包的选项，简化了管理 UI，删除了summary.json 状态"
+      },
       "0.1.5": {
         "en": "Added auto-merge config, weekly Dependabot schedule, actions/checkout v6",
         "de": "Auto-Merge-Konfiguration hinzugefügt, wöchentlicher Dependabot-Zeitplan, actions/checkout v6",
@@ -67,19 +93,6 @@
         "pl": "Przeprojektowano logo adaptera, naprawiono problemy repochecker",
         "uk": "Оновлено логотип адаптера, виправлено проблеми repochecker",
         "zh-cn": "重新设计适配器图标，修复 repochecker 问题"
-      },
-      "0.1.0": {
-        "en": "Initial release — track packages from 300+ carriers via parcel.app",
-        "de": "Erstveröffentlichung — Pakete von 300+ Versandunternehmen über parcel.app verfolgen",
-        "ru": "Первый выпуск — отслеживание посылок от 300+ перевозчиков через parcel.app",
-        "pt": "Lançamento inicial — rastreie pacotes de mais de 300 transportadoras via parcel.app",
-        "nl": "Eerste release — volg pakketten van 300+ vervoerders via parcel.app",
-        "fr": "Version initiale — suivez vos colis de plus de 300 transporteurs via parcel.app",
-        "it": "Prima versione — traccia pacchi da più di 300 corrieri tramite parcel.app",
-        "es": "Versión inicial — rastrea paquetes de más de 300 transportistas a través de parcel.app",
-        "pl": "Pierwsze wydanie — śledź przesyłki od 300+ przewoźników przez parcel.app",
-        "uk": "Перший випуск — відстеження посилок від 300+ перевізників через parcel.app",
-        "zh-cn": "初始版本 — 通过 parcel.app 追踪 300+ 快递公司的包裹"
       }
     },
     "titleLang": {
@@ -161,8 +174,8 @@
   "native": {
     "apiKey": "",
     "pollInterval": 10,
-    "filterMode": "active",
-    "language": "de"
+    "language": "de",
+    "autoRemoveDelivered": true
   },
   "instanceObjects": [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.parcelapp",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "description": "ioBroker adapter for parcel.app — track packages from 300+ carriers",
   "author": {
     "name": "krobi",
@@ -61,6 +61,7 @@
     "test:integration": "npm run build:test && mocha --exit \"build/test/**/*.js\"",
     "test": "npm run build:test && mocha --exit \"build/test/**/*.js\"",
     "test:ci": "npm run build:test && mocha --exit --reporter spec \"build/test/**/*.js\"",
+    "translate": "translate-adapter",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
     "release": "release-script"