iobroker.poolcontrol 1.4.1 → 1.4.2

package/README.md

@@ -283,6 +283,18 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.4.2 (2026-07-01)
+
+- Fixed monthly temperature statistics reset scheduling
+  - Monthly reset no longer uses long timeouts above the Node.js/ioBroker limit
+  - Added persistent monthly period tracking
+  - Missed month changes after adapter downtime are detected safely
+  - Monthly reset is now checked daily and executed only once per period
+
+- Improved solar logbook logging
+  - Oversized solar logbook entries are now logged as debug instead of warning
+  - This avoids unnecessary warning noise for non-critical diagnostic information
+
 ### 1.4.1 (2026-06-30)
 
 - Fixed Auto-PV holding logic for already running pumps.
@@ -314,13 +326,6 @@ New features are added regularly – please refer to the changelog.
 - **Additional safeguards:** Added size protection for the solar logbook and debug log to prevent uncontrolled state growth.
 - **Maintenance:** Updated the `@iobroker/adapter-core` dependency to the latest recommended version.
 
-### 1.3.33 (2026-06-18)
-
-- Added live delta states for standard solar and Solar Extended control:
-  - `solar.collector_surface_delta`
-  - `solar.extended.collector_pool_reference_delta`
-- Documented that runtime changes to `solar.extended.pool_temperature_source` are applied automatically, but may take up to approximately 60 seconds due to the Solar Extended cyclic check interval.
-
 ## Archived Release History
 
 For older releases and archived version history see:

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.4.1",
+    "version": "1.4.2",
     "news": {
+      "1.4.2": {
+        "en": "Fixed monthly temperature statistics reset scheduling to avoid long timeout errors on Node.js/ioBroker. Reduced oversized solar logbook warning to debug level.",
+        "de": "Monatsreset der Temperaturstatistik korrigiert, damit keine zu langen Timeout-Fehler unter Node.js/ioBroker entstehen. Überdimensionierte Solar-Logbuch-Hinweise von Warn auf Debug reduziert.",
+        "ru": "Исправлено расписание сброса ежемесячной статистики температуры, чтобы избежать ошибок длительного ожидания в Node.js/ioBroker. Уменьшено предупреждение о слишком большом размере журнала солнечной энергии до уровня отладки.",
+        "pt": "Corrigida a programação de redefinição de estatísticas mensais de temperatura para evitar longos erros de tempo limite no Node.js/ioBroker. Aviso de diário de bordo solar superdimensionado reduzido para o nível de depuração.",
+        "nl": "Vaste maandelijkse temperatuurstatistieken die de planning resetten om lange time-outfouten op Node.js/ioBroker te voorkomen. Waarschuwing voor te groot zonne-logboek teruggebracht tot foutopsporingsniveau.",
+        "fr": "Correction des statistiques de température mensuelles réinitialisant la planification pour éviter les longues erreurs de délai d'attente sur Node.js/ioBroker. Réduction des avertissements du journal solaire surdimensionné au niveau du débogage.",
+        "it": "Risolte le statistiche mensili sulla temperatura che ripristinano la pianificazione per evitare errori di timeout lunghi su Node.js/ioBroker. Avviso di registro solare sovradimensionato ridotto al livello di debug.",
+        "es": "Se corrigieron las estadísticas de temperatura mensuales que restablecen la programación para evitar errores de tiempo de espera prolongados en Node.js/ioBroker. Se redujo la advertencia del libro de registro solar de gran tamaño al nivel de depuración.",
+        "pl": "Naprawiono harmonogram resetowania miesięcznych statystyk temperatury, aby uniknąć błędów związanych z długim przekroczeniem limitu czasu w Node.js/ioBroker. Zmniejszono ostrzeżenie o zbyt dużym dzienniku słonecznym do poziomu debugowania.",
+        "uk": "Виправлено розклад скидання щомісячної статистики температури, щоб уникнути помилок тривалого очікування на Node.js/ioBroker. Зменшено попередження про надмірний сонячний журнал до рівня налагодження.",
+        "zh-cn": "修复了每月温度统计重置计划，以避免 Node.js/ioBroker 上的长时间超时错误。将超大太阳能日志警告减少到调试级别。"
+      },
       "1.4.1": {
         "en": "Fixed Auto-PV holding logic so a running pump no longer reduces its own available PV power calculation. The displayed PV surplus remains unchanged.",
         "de": "Korrigiert die Auto-PV-Haltebedingung, damit eine laufende Pumpe ihre eigene verfügbare PV-Leistung nicht mehr rechnerisch reduziert. Der angezeigte PV-Überschuss bleibt unverändert.",
@@ -54,19 +67,6 @@
         "pl": "Ulepszona architektura historii chemii z chronioną historią krótkoterminową i codzienną, zapobieganie nadmiernym stanom JSON, dodane zabezpieczenia przed rozrostem bazy danych stanu, ulepszona ochrona dziennika solarnego/dziennika debugowania oraz zaktualizowana zależność od rdzenia adaptera.",
         "uk": "Покращена архітектура хімічної історії із захищеною короткостроковою та щоденною історією, запобіганням надмірним станам JSON, доданим запобіжним засобам проти зростання бази даних стану, покращеному захисту сонячного журналу/журналу налагодження та оновленій залежності ядра адаптера.",
         "zh-cn": "改进了化学历史架构，具有受保护的短期和每日历史记录，防止过大的 JSON 状态，增加了针对状态数据库增长的保护措施，增强了太阳能日志/调试日志保护，并更新了适配器核心依赖性。"
-      },
-      "1.3.33": {
-        "en": "Added live delta states for standard solar and Solar Extended control. Documented Solar Extended pool reference runtime update behavior.",
-        "de": "Live-Delta-Datenpunkte für Standard-Solar und Solar Extended ergänzt. Laufzeitverhalten der Solar-Extended-Poolreferenz dokumentiert.",
-        "ru": "Добавлены дельта-состояния в реальном времени для стандартного и расширенного управления солнечной энергией. Документированное поведение обновления во время выполнения ссылки на расширенный пул Solar.",
-        "pt": "Adicionados estados delta ao vivo para controle solar padrão e solar estendido. Comportamento de atualização de tempo de execução de referência do pool Solar Extended documentado.",
-        "nl": "Live deltatoestanden toegevoegd voor standaard zonne-energie en Solar Extended-regeling. Gedocumenteerd runtime-updategedrag van de Solar Extended-poolreferentie.",
-        "fr": "Ajout d'états delta en direct pour le contrôle solaire standard et solaire étendu. Comportement documenté de la mise à jour du runtime de référence du pool Solar Extended.",
-        "it": "Aggiunti stati delta live per il controllo solare standard e Solar Extended. Comportamento documentato dell'aggiornamento runtime di riferimento del pool Solar Extended.",
-        "es": "Se agregaron estados delta en vivo para control solar estándar y solar extendido. Comportamiento de actualización del tiempo de ejecución de referencia del grupo Solar Extended documentado.",
-        "pl": "Dodano stany delta na żywo dla standardowego sterowania solarnego i Solar Extended. Udokumentowane zachowanie aktualizacji środowiska uruchomieniowego referencyjnej puli Solar Extended.",
-        "uk": "Додано живі дельта-стани для стандартного сонячного та розширеного керування Solar. Задокументована поведінка оновлення середовища виконання довідкового пулу Solar Extended.",
-        "zh-cn": "为标准太阳能和太阳能扩展控制添加了实时增量状态。记录了 Solar Extended 池参考运行时更新行为。"
       }
     },
     "titleLang": {

package/lib/helpers/solarLogbookHelper.js

@@ -539,7 +539,7 @@ const solarLogbookHelper = {
         }
 
         if (wasTrimmed) {
-            this.adapter.log.warn('[solarLogbookHelper] Day log was trimmed to keep JSON and text within 64 KB.');
+            this.adapter.log.debug('[solarLogbookHelper] Day log was trimmed to keep JSON and text within 64 KB.');
         }
 
         return { entries: limitedEntries, json, text };
@@ -617,7 +617,7 @@ const solarLogbookHelper = {
         }
 
         if (Buffer.byteLength(jsonText, 'utf8') > MAX_LOGBOOK_BYTES) {
-            this.adapter.log.warn('[solarLogbookHelper] Oversized day_log_json was discarded before parsing.');
+            this.adapter.log.debug('[solarLogbookHelper] Oversized day_log_json was discarded before parsing.');
             return [];
         }
 

package/lib/helpers/statisticsHelperMonth.js

@@ -19,6 +19,9 @@ const statisticsHelperMonth = {
     adapter: null,
     monthResetTimer: null,
     isResetting: false,
+    isPeriodCheckRunning: false,
+    periodStateId: 'analytics.statistics.temperature.month.last_processed_period',
+    maxCheckIntervalMs: 24 * 60 * 60 * 1000,
     sensors: [
         { id: 'outside', name: 'Außentemperatur' },
         { id: 'ground', name: 'Bodentemperatur' },
@@ -42,6 +45,13 @@ const statisticsHelperMonth = {
         try {
             await this._createTemperatureStatistics();
             await this._subscribeActiveSensors();
+
+            try {
+                await this._checkMonthPeriod();
+            } catch (err) {
+                adapter.log.warn(`statisticsHelperMonth: Error while checking monthly period: ${err.message}`);
+            }
+
             await this._scheduleMonthReset();
             adapter.log.debug('statisticsHelperMonth: Initialization completed (sensor monitoring active).');
         } catch (err) {
@@ -151,6 +161,20 @@ const statisticsHelperMonth = {
                 await adapter.setStateAsync(fullPath, { val: out.id.endsWith('json') ? '{}' : '', ack: true });
             }
         }
+
+        await adapter.setObjectNotExistsAsync(this.periodStateId, {
+            type: 'state',
+            common: {
+                name: 'Last processed monthly statistics period',
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: false,
+                def: '',
+                persist: true,
+            },
+            native: {},
+        });
     },
 
     /**
@@ -343,7 +367,47 @@ const statisticsHelperMonth = {
     },
 
     /**
-     * Monats-Reset planen (1. Tag des Monats 00:05 Uhr)
+     * Prüft, ob seit dem letzten erfolgreichen Reset ein neuer Monat begonnen hat.
+     */
+    async _checkMonthPeriod() {
+        if (this.isPeriodCheckRunning) {
+            this.adapter.log.debug('statisticsHelperMonth: Monthly period check already running – skipped.');
+            return;
+        }
+
+        this.isPeriodCheckRunning = true;
+
+        try {
+            const currentPeriod = this._getCurrentPeriodKey();
+            const periodState = await this.adapter.getStateAsync(this.periodStateId);
+            const lastProcessedPeriod = typeof periodState?.val === 'string' ? periodState.val.trim() : '';
+
+            if (!lastProcessedPeriod) {
+                await this.adapter.setStateAsync(this.periodStateId, { val: currentPeriod, ack: true });
+                this.adapter.log.debug(
+                    `statisticsHelperMonth: Monthly period initialized with ${currentPeriod}; no reset required.`,
+                );
+                return;
+            }
+
+            if (lastProcessedPeriod === currentPeriod) {
+                return;
+            }
+
+            const resetSuccessful = await this._resetMonthlyTemperatureStats();
+            if (!resetSuccessful) {
+                throw new Error(`Monthly reset for period ${currentPeriod} was not completed`);
+            }
+
+            await this.adapter.setStateAsync(this.periodStateId, { val: currentPeriod, ack: true });
+            this.adapter.log.debug(`statisticsHelperMonth: Monthly period ${currentPeriod} marked as processed.`);
+        } finally {
+            this.isPeriodCheckRunning = false;
+        }
+    },
+
+    /**
+     * Nächsten Monatsperioden-Check planen (täglich um 00:10 Uhr, maximal 24 Stunden).
      */
     async _scheduleMonthReset() {
         if (this.monthResetTimer) {
@@ -352,39 +416,33 @@ const statisticsHelperMonth = {
         }
 
         const now = new Date();
-        const nextReset = new Date(now.getFullYear(), now.getMonth() + 1, 1, 0, 5, 0, 0);
-        let msUntilReset = nextReset.getTime() - now.getTime();
-
-        // // Wenn heute bereits der 1. ist → keinen sofortigen Reset starten!
-        // if (now.getDate() === 1) {
-        //     this.adapter.log.debug('statisticsHelperMonth: Today is already the 1st – reset skipped.');
-        //    // Plan auf nächsten Monat verschieben
-        //     nextReset.setMonth(nextReset.getMonth() + 1);
-        //     msUntilReset = nextReset.getTime() - now.getTime();
-        // }
-
-        // Wenn Berechnung negativ oder zu klein ist → Sicherheit
-        if (msUntilReset <= 0 || msUntilReset < 10 * 60 * 1000) {
-            this.adapter.log.debug('statisticsHelperMonth: msUntilReset was too small – adjusting timer.');
-            msUntilReset = 10 * 60 * 1000; // mindestens 10 Minuten warten
+        const nextCheck = new Date(now);
+        nextCheck.setHours(0, 10, 0, 0);
+        if (nextCheck <= now) {
+            nextCheck.setDate(nextCheck.getDate() + 1);
         }
+        const msUntilCheck = Math.min(nextCheck.getTime() - now.getTime(), this.maxCheckIntervalMs);
 
-        // Timer setzen
         this.monthResetTimer = this.adapter.setTimeout(async () => {
             this.monthResetTimer = null;
 
-            if (this.isResetting) {
-                this.adapter.log.debug('statisticsHelperMonth: Reset already running – timer skipped.');
-                await this._scheduleMonthReset();
-                return;
+            try {
+                await this._checkMonthPeriod();
+            } catch (err) {
+                this.adapter.log.warn(`statisticsHelperMonth: Error during monthly period check: ${err.message}`);
             }
 
-            await this._resetMonthlyTemperatureStats();
-            await this._scheduleMonthReset();
-        }, msUntilReset);
+            try {
+                await this._scheduleMonthReset();
+            } catch (err) {
+                this.adapter.log.warn(
+                    `statisticsHelperMonth: Error while scheduling monthly period check: ${err.message}`,
+                );
+            }
+        }, msUntilCheck);
 
         this.adapter.log.debug(
-            `statisticsHelperMonth: Monthly reset scheduled in ${Math.round(msUntilReset / 60000)} minutes.`,
+            `statisticsHelperMonth: Monthly period check scheduled in ${Math.round(msUntilCheck / 60000)} minutes.`,
         );
     },
 
@@ -394,24 +452,9 @@ const statisticsHelperMonth = {
     async _resetMonthlyTemperatureStats() {
         const adapter = this.adapter;
 
-        // 🟢 Neuer Logikblock: Monatsreset erfolgt nur, wenn wirklich neuer Monat begonnen hat
-        try {
-            const now = new Date();
-            const currentDay = now.getDate();
-
-            // Nur am 1. Tag des Monats ausführen (00:05 Uhr geplant)
-            if (currentDay !== 1) {
-                adapter.log.debug('[statisticsHelperMonth] Not the first day of the month – reset skipped.');
-                return;
-            }
-        } catch (err) {
-            adapter.log.warn(`[statisticsHelperMonth] Error while checking month start: ${err.message}`);
-        }
-
-        // 🟢 NEU: Schutz vor Endlosschleifen und Mehrfachausführung
         if (this.isResetting) {
             adapter.log.debug('statisticsHelperMonth: Reset already active – skipped.');
-            return;
+            return false;
         }
         this.isResetting = true;
 
@@ -486,10 +529,12 @@ const statisticsHelperMonth = {
             });
 
             adapter.log.debug('statisticsHelperMonth: Monthly statistics reset completed.');
+            return true;
         } catch (err) {
             adapter.log.warn(`statisticsHelperMonth: Error during monthly reset: ${err.message}`);
+            return false;
         } finally {
-            this.isResetting = false; // 🟢 NEU: Flag wieder freigeben
+            this.isResetting = false;
         }
     },
 
@@ -515,6 +560,18 @@ const statisticsHelperMonth = {
         return `${month.charAt(0).toUpperCase() + month.slice(1)} ${year}`;
     },
 
+    /**
+     * Gibt die aktuelle lokale Monatsperiode als YYYY-MM zurück.
+     *
+     * @param {Date} date Zu formatierender lokaler Zeitpunkt
+     * @returns {string} Lokaler Monats-Schlüssel
+     */
+    _getCurrentPeriodKey(date = new Date()) {
+        const year = date.getFullYear();
+        const month = String(date.getMonth() + 1).padStart(2, '0');
+        return `${year}-${month}`;
+    },
+
     cleanup() {
         if (this.monthResetTimer) {
             this.adapter.clearTimeout(this.monthResetTimer);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.poolcontrol",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Steuerung & Automatisierung für den Pool (Pumpe, Heizung, Ventile, Sensoren).",
   "author": "DasBo1975 <dasbo1975@outlook.de>",
   "homepage": "https://github.com/DasBo1975/ioBroker.poolcontrol",