iobroker.nuasense 0.2.0 → 0.2.2

package/README.md

@@ -9,11 +9,11 @@
 
 ## NuaSense adapter for ioBroker
 
-What your weather station means for your house and garden, as ioBroker states — and, if you like, your station forwarded from ioBroker to NuaSense. The first three stations on a NuaSense account connect free.
+What your weather station means for your house and garden, as ioBroker states — and, if you like, your station forwarded from ioBroker to [NuaSense](https://nuasense.com). The first three stations on a NuaSense account connect free.
 
 ### Read
 
-Make an API key in the NuaSense console under **API Keys** (scope `ingest:write`; it is what reads your own stations), put it into the adapter, and tell it what the garden mostly is (lawn, vegetables, flower beds and shrubs) and your sprinkler's rate in mm per hour (pop-up sprinkler about 10, drip line 2–4; 0 for millimetres only). Every 15 minutes (configurable) the adapter writes, per station:
+Make an API key in the [NuaSense console](https://platform.nuasense.com) under **API Keys** (scope `ingest:write`; it is what reads your own stations), put it into the adapter, and tell it what the garden mostly is (lawn, vegetables, flower beds and shrubs) and your sprinkler's rate in mm per hour (pop-up sprinkler about 10, drip line 2–4; 0 for millimetres only). Every 15 minutes (configurable) the adapter writes, per station:
 
 | state | meaning |
 |---|---|
@@ -46,6 +46,12 @@ When you connect a station, NuaSense stores its readings and computes your forec
     Placeholder for the next version (at the beginning of the line):
     ### **WORK IN PROGRESS**
 -->
+### 0.2.2 (2026-11-09)
+* (NuaSense) object structure for the review: folders and channels for all states, valid roles, no null values
+
+### 0.2.1 (2026-11-05)
+* (NuaSense) checker fixes: workflow and tooling
+
 ### 0.2.0 (2026-11-05)
 * (NuaSense) house & garden first: frost tonight, watering today in mm and minutes, rain next 24 h, plausibility; agronomy values behind Advanced
 
@@ -55,6 +61,8 @@ When you connect a station, NuaSense stores its readings and computes your forec
 ### 0.1.0 (2026-11-03)
 * (NuaSense) first release: first look and hourly agronomy as states; optional forwarding of a station from ioBroker to NuaSense
 
+Older changes: [CHANGELOG_OLD.md](CHANGELOG_OLD.md)
+
 ## License
 MIT License
 

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "nuasense",
-    "version": "0.2.0",
+    "version": "0.2.2",
     "news": {
+      "0.2.2": {
+        "en": "Object structure for the review: folders and channels for all states, valid roles, no null values",
+        "de": "Objektstruktur für das Review: Ordner und Kanäle für alle States, gültige Rollen, keine Nullwerte",
+        "ru": "Структура объектов для проверки: папки и каналы для всех состояний, допустимые роли, без значений null",
+        "pt": "Estrutura de objetos para a revisão: pastas e canais para todos os estados, funções válidas, sem valores nulos",
+        "nl": "Objectstructuur voor de review: mappen en kanalen voor alle states, geldige rollen, geen null-waarden",
+        "fr": "Structure des objets pour la revue : dossiers et canaux pour tous les états, rôles valides, aucune valeur nulle",
+        "it": "Struttura degli oggetti per la revisione: cartelle e canali per tutti gli stati, ruoli validi, nessun valore nullo",
+        "es": "Estructura de objetos para la revisión: carpetas y canales para todos los estados, roles válidos, sin valores nulos",
+        "pl": "Struktura obiektów do przeglądu: foldery i kanały dla wszystkich stanów, poprawne role, bez wartości null",
+        "uk": "Структура об'єктів для перевірки: папки та канали для всіх станів, допустимі ролі, без значень null",
+        "zh-cn": "用于审核的对象结构：所有状态都有文件夹和通道，角色有效，没有空值"
+      },
+      "0.2.1": {
+        "en": "Checker fixes: workflow and tooling",
+        "de": "Checker-Korrekturen: Workflow und Werkzeuge",
+        "ru": "Исправления по чекеру: рабочий процесс и инструменты",
+        "pt": "Correções do verificador: fluxo de trabalho e ferramentas",
+        "nl": "Checker-fixes: workflow en tooling",
+        "fr": "Corrections du vérificateur : flux de travail et outils",
+        "it": "Correzioni del checker: flusso di lavoro e strumenti",
+        "es": "Correcciones del verificador: flujo de trabajo y herramientas",
+        "pl": "Poprawki checkera: proces i narzędzia",
+        "uk": "Виправлення за чекером: робочий процес та інструменти",
+        "zh-cn": "检查器修复：工作流与工具"
+      },
       "0.2.0": {
         "en": "House & garden first: frost tonight, watering today in mm and minutes, rain next 24 h, plausibility; agronomy values behind Advanced",
         "de": "Haus & Garten zuerst: Frost heute Nacht, Giessen heute in mm und Minuten, Regen der nächsten 24 h, Plausibilität; Agronomie-Werte unter «Erweitert»",
@@ -16,19 +42,6 @@
         "uk": "Спочатку дім і сад: заморозки вночі, полив сьогодні в мм і хвилинах, дощ на 24 год, правдоподібність; агрономічні значення в розділі «Розширені»",
         "zh-cn": "优先家居与花园：今夜霜冻、今日浇水量（毫米与分钟）、未来 24 小时降雨、合理性；农艺数值放在“高级”中"
       },
-      "0.1.1": {
-        "en": "Checker fixes: Node.js 22, i18n for the admin UI, responsive sizes, trusted publishing workflow",
-        "de": "Checker-Korrekturen: Node.js 22, i18n für die Admin-Oberfläche, responsive Größen, Trusted-Publishing-Workflow",
-        "ru": "Исправления по чекеру: Node.js 22, i18n для панели администратора, адаптивные размеры, рабочий процесс доверенной публикации",
-        "pt": "Correções do verificador: Node.js 22, i18n para a interface de administração, tamanhos responsivos, fluxo de publicação confiável",
-        "nl": "Checker-fixes: Node.js 22, i18n voor de beheer-UI, responsieve groottes, trusted-publishing-workflow",
-        "fr": "Corrections du vérificateur : Node.js 22, i18n pour l'interface d'administration, tailles responsives, flux de publication de confiance",
-        "it": "Correzioni del checker: Node.js 22, i18n per l'interfaccia di amministrazione, dimensioni responsive, flusso di pubblicazione attendibile",
-        "es": "Correcciones del verificador: Node.js 22, i18n para la interfaz de administración, tamaños adaptables, flujo de publicación de confianza",
-        "pl": "Poprawki checkera: Node.js 22, i18n dla panelu administracyjnego, rozmiary responsywne, zaufany proces publikacji",
-        "uk": "Виправлення за чекером: Node.js 22, i18n для панелі адміністратора, адаптивні розміри, довірений процес публікації",
-        "zh-cn": "检查器修复：Node.js 22、管理界面 i18n、响应式尺寸、可信发布工作流"
-      },
       "0.1.0": {
         "en": "First release: first look and hourly agronomy as states; optional forwarding of a station from ioBroker to NuaSense",
         "de": "Erste Version: Erster Blick und stündliche Agronomie als States; optional Weiterleitung einer Station von ioBroker zu NuaSense",

package/lib/ecowitt.js

@@ -1,4 +1,4 @@
-"use strict";
+'use strict';
 
 /**
  * Metric readings in, an Ecowitt-format upload out.
@@ -10,7 +10,7 @@
  * path to it. Everything here is pure, so it is tested without Node-RED.
  */
 
-const crypto = require("node:crypto");
+const crypto = require('node:crypto');
 
 const INHG_PER_HPA = 1 / 33.8639;
 const MPH_PER_MS = 1 / 0.44704;
@@ -19,31 +19,31 @@ const IN_PER_MM = 1 / 25.4;
 // used the other way, so a flow that only has lux lands on the same number.
 const LUX_PER_WM2 = 120;
 
-const num = (v) => {
-  if (v === null || v === undefined || v === "") {
-    return null;
-  }
-  const n = Number(v);
-  return Number.isFinite(n) ? n : null;
+const num = v => {
+    if (v === null || v === undefined || v === '') {
+        return null;
+    }
+    const n = Number(v);
+    return Number.isFinite(n) ? n : null;
 };
 const fix = (n, digits) => (n === null ? null : Number(n.toFixed(digits)));
 
 /** Ecowitt's `dateutc`: "YYYY-MM-DD HH:MM:SS", UTC. */
 function dateUtc(when) {
-  const d = when instanceof Date ? when : when ? new Date(when) : new Date();
-  if (Number.isNaN(d.getTime())) {
-    return dateUtc(new Date());
-  }
-  return d.toISOString().slice(0, 19).replace("T", " ");
+    const d = when instanceof Date ? when : when ? new Date(when) : new Date();
+    if (Number.isNaN(d.getTime())) {
+        return dateUtc(new Date());
+    }
+    return d.toISOString().slice(0, 19).replace('T', ' ');
 }
 
 /** A stable 32-hex PASSKEY from whatever names the device in the flow. */
 function passkeyFor(deviceId) {
-  return crypto
-    .createHash("md5")
-    .update(String(deviceId || "node-red"), "utf8")
-    .digest("hex")
-    .toUpperCase();
+    return crypto
+        .createHash('md5')
+        .update(String(deviceId || 'node-red'), 'utf8')
+        .digest('hex')
+        .toUpperCase();
 }
 
 /**
@@ -53,86 +53,81 @@ function passkeyFor(deviceId) {
  *   solar_wm2 (W/m²) or light_lux, time (ISO or Date; now when absent)
  * @returns the form fields, as strings, in the order a console sends them
  */
-function toEcowitt(
-  reading,
-  { deviceId, stationType = "node-red-contrib-nuasense" } = {},
-) {
-  const r = reading && typeof reading === "object" ? reading : {};
-  const fields = {
-    PASSKEY: passkeyFor(deviceId),
-    stationtype: stationType,
-    dateutc: dateUtc(r.time),
-  };
-  const t = num(r.temperature);
-  if (t !== null) {
-    fields.tempf = String(fix((t * 9) / 5 + 32, 2));
-  }
-  const h = num(r.humidity);
-  if (h !== null) {
-    fields.humidity = String(Math.round(h));
-  }
-  const p = num(r.pressure);
-  if (p !== null) {
-    fields.baromabsin = String(fix(p * INHG_PER_HPA, 3));
-  }
-  const ws = num(r.wind_speed);
-  if (ws !== null) {
-    fields.windspeedmph = String(fix(ws * MPH_PER_MS, 2));
-  }
-  const wg = num(r.wind_gusts);
-  if (wg !== null) {
-    fields.windgustmph = String(fix(wg * MPH_PER_MS, 2));
-  }
-  const wd = num(r.wind_direction);
-  if (wd !== null) {
-    fields.winddir = String(Math.round(((wd % 360) + 360) % 360));
-  }
-  const rain = num(r.rain_total_mm);
-  if (rain !== null) {
-    fields.yearlyrainin = String(fix(rain * IN_PER_MM, 3));
-  }
-  const sol = num(r.solar_wm2);
-  const lux = num(r.light_lux);
-  if (sol !== null) {
-    fields.solarradiation = String(fix(sol, 2));
-  } else if (lux !== null) {
-    fields.solarradiation = String(fix(lux / LUX_PER_WM2, 2));
-  }
-  const uv = num(r.uv);
-  if (uv !== null) {
-    fields.uv = String(Math.round(uv));
-  }
-  return fields;
+function toEcowitt(reading, { deviceId, stationType = 'node-red-contrib-nuasense' } = {}) {
+    const r = reading && typeof reading === 'object' ? reading : {};
+    const fields = {
+        PASSKEY: passkeyFor(deviceId),
+        stationtype: stationType,
+        dateutc: dateUtc(r.time),
+    };
+    const t = num(r.temperature);
+    if (t !== null) {
+        fields.tempf = String(fix((t * 9) / 5 + 32, 2));
+    }
+    const h = num(r.humidity);
+    if (h !== null) {
+        fields.humidity = String(Math.round(h));
+    }
+    const p = num(r.pressure);
+    if (p !== null) {
+        fields.baromabsin = String(fix(p * INHG_PER_HPA, 3));
+    }
+    const ws = num(r.wind_speed);
+    if (ws !== null) {
+        fields.windspeedmph = String(fix(ws * MPH_PER_MS, 2));
+    }
+    const wg = num(r.wind_gusts);
+    if (wg !== null) {
+        fields.windgustmph = String(fix(wg * MPH_PER_MS, 2));
+    }
+    const wd = num(r.wind_direction);
+    if (wd !== null) {
+        fields.winddir = String(Math.round(((wd % 360) + 360) % 360));
+    }
+    const rain = num(r.rain_total_mm);
+    if (rain !== null) {
+        fields.yearlyrainin = String(fix(rain * IN_PER_MM, 3));
+    }
+    const sol = num(r.solar_wm2);
+    const lux = num(r.light_lux);
+    if (sol !== null) {
+        fields.solarradiation = String(fix(sol, 2));
+    } else if (lux !== null) {
+        fields.solarradiation = String(fix(lux / LUX_PER_WM2, 2));
+    }
+    const uv = num(r.uv);
+    if (uv !== null) {
+        fields.uv = String(Math.round(uv));
+    }
+    return fields;
 }
 
 function encodeForm(fields) {
-  return Object.entries(fields)
-    .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
-    .join("&");
+    return Object.entries(fields)
+        .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
+        .join('&');
 }
 
 /** The upload URL for a token as it is shown: kw7n-4hpd-x2vt (hyphens are fine on the wire). */
 function uploadUrl(server, token) {
-  const host = String(server || "ingest.nuasense.com")
-    .trim()
-    .replace(/^https?:\/\//, "")
-    .replace(/\/+$/, "");
-  const tok = String(token || "")
-    .trim()
-    .toLowerCase();
-  if (!/^[a-z0-9-]{12,29}$/.test(tok)) {
-    throw new Error(
-      "the station path token looks wrong — copy it from the console",
-    );
-  }
-  return `http://${host}/station/${tok}`;
+    const host = String(server || 'ingest.nuasense.com')
+        .trim()
+        .replace(/^https?:\/\//, '')
+        .replace(/\/+$/, '');
+    const tok = String(token || '')
+        .trim()
+        .toLowerCase();
+    if (!/^[a-z0-9-]{12,29}$/.test(tok)) {
+        throw new Error('the station path token looks wrong — copy it from the console');
+    }
+    return `http://${host}/station/${tok}`;
 }
 
 module.exports = {
-  toEcowitt,
-  encodeForm,
-  uploadUrl,
-  passkeyFor,
-  dateUtc,
-  LUX_PER_WM2,
+    toEcowitt,
+    encodeForm,
+    uploadUrl,
+    passkeyFor,
+    dateUtc,
+    LUX_PER_WM2,
 };