iobroker.mg-saic 0.1.0 → 0.1.2

package/README.md

@@ -3,15 +3,17 @@
 [![NPM version](https://img.shields.io/npm/v/iobroker.mg-saic.svg)](https://www.npmjs.com/package/iobroker.mg-saic)
 [![Downloads](https://img.shields.io/npm/dm/iobroker.mg-saic.svg)](https://www.npmjs.com/package/iobroker.mg-saic)
 
-<img src="MG.png" alt="MG" width="314">
+<img src="admin/MG.png" alt="MG" width="314">
 
 The adapter is intended for connecting MG and SAIC vehicles to ioBroker through the iSmart cloud service. It is not affiliated with or endorsed by MG, SAIC, or iSmart.
 
+For manufacturer information, see [MG Motor](https://www.mgmotor.eu/) and [SAIC Motor](https://www.saicmotor.com/).
+
 ## Setup
 
 ### Before you start
 
-- Node.js 24.0.0 or later is required.
+- Node.js 22.22.2 or later is required.
 - ioBroker js-controller 7.2.2 or later is required.
 - ioBroker Admin 8.2.0 or later is required.
 - Use an iSmart account that has access to the vehicle. A separate account shared with the vehicle is recommended to avoid interfering with the mobile app session.
@@ -23,7 +25,7 @@ The adapter is intended for connecting MG and SAIC vehicles to ioBroker through
 1. Install the adapter and create an instance in ioBroker Admin.
 2. Select the account region and login type (email or phone number).
 3. Enter the account's email address or phone number and password. For phone login, also enter the phone country calling code.
-4. Set the status polling interval in seconds. The default is 1800 seconds.
+4. Set the status polling interval >60 seconds. The default is 1800 seconds.
 5. Save the settings and start the instance. Vehicles available to the account appear under `vehicles.<VIN>`.
 
 ## Features
@@ -34,13 +36,24 @@ The adapter is intended for connecting MG and SAIC vehicles to ioBroker through
 
 ## Installation
 
-The adapter is published on npm but has not yet been added to the ioBroker adapter catalog.
+The adapter is published on npm and available from ioBroker's Latest adapter repository.
 
 ## Support
 
 [![Donate](https://camo.githubusercontent.com/ef8c60305542390406855547e32850909812a73c4abada236de22a6dc88b313f/68747470733a2f2f7777772e70617970616c6f626a656374732e636f6d2f64655f44452f44452f692f62746e2f62746e5f646f6e61746543435f4c472e676966)](https://www.paypal.com/donate/?hosted_button_id=3RJQGSJNRSHUJ)
 
 ## Changelog
+### 0.1.2 (2026-11-08)
+
+- (Voodoo2man) Prevented unsafe or case-colliding API fields and vehicle IDs from creating duplicate datapoints, kept status IDs stable across field-casing changes, scheduled polling after each completed cycle while honoring queued manual refreshes, and removed an unused cloud-backend translation.
+- (Voodoo2man) Replaced untrusted cloud error text with English code-based diagnostics and standardized the product title as MG/SAIC across locales.
+- (Voodoo2man) Reused dynamic charging datapoints across field-name casing changes and normalized known status fields.
+
+### 0.1.1 (2026-11-07)
+
+- (Voodoo2man) Lowered the minimum Node.js requirement to 22.22.2.
+- (Voodoo2man) Improved charging datapoint labels and units, enforced safe polling interval limits, and added manufacturer references.
+
 ### 0.1.0 (2026-11-01)
 
 - (Voodoo2man) Reported real-time charging power in kW using the pack current and voltage.
@@ -62,14 +75,6 @@ The adapter is published on npm but has not yet been added to the ioBroker adapt
 
 Older changelog entries are available in [CHANGELOG_OLD.md](CHANGELOG_OLD.md).
 
-### 0.0.2 (2026-10-20)
-
-- (Voodoo2man) Added regional iSmart account setup, vehicle status, and supported remote controls.
-
-### 0.0.1 (2026-10-20)
-
-- (Voodoo2man) Initial Version
-
 ## License
 
 MIT License

package/admin/i18n/de.json

@@ -7,7 +7,6 @@
 	"Region": "Region",
 	"European Union": "Europäische Union",
 	"Rest of World": "Rest der Welt",
-	"Cloud connectivity is not implemented yet. This value does not select a working backend.": "Die Cloud-Anbindung ist noch nicht implementiert. Dieser Wert wählt kein funktionsfähiges Backend aus.",
 	"Login type": "Anmeldetyp",
 	"Email": "E-Mail",
 	"Phone number": "Telefonnummer",

package/admin/i18n/en.json

@@ -7,7 +7,6 @@
 	"Region": "Region",
 	"European Union": "European Union",
 	"Rest of World": "Rest of World",
-	"Cloud connectivity is not implemented yet. This value does not select a working backend.": "Cloud connectivity is not implemented yet. This value does not select a working backend.",
 	"Login type": "Login type",
 	"Email": "Email",
 	"Phone number": "Phone number",

package/admin/i18n/es.json

@@ -7,7 +7,6 @@
 	"Region": "Región",
 	"European Union": "Unión Europea",
 	"Rest of World": "Resto del mundo",
-	"Cloud connectivity is not implemented yet. This value does not select a working backend.": "La conexión a la nube aún no está implementada. Este valor no selecciona un servicio operativo.",
 	"Login type": "Tipo de inicio de sesión",
 	"Email": "Correo electrónico",
 	"Phone number": "Número de teléfono",

package/admin/i18n/fr.json

@@ -7,7 +7,6 @@
 	"Region": "Région",
 	"European Union": "Union européenne",
 	"Rest of World": "Reste du monde",
-	"Cloud connectivity is not implemented yet. This value does not select a working backend.": "La connexion au cloud n'est pas encore implémentée. Cette valeur ne sélectionne pas de service fonctionnel.",
 	"Login type": "Type de connexion",
 	"Email": "E-mail",
 	"Phone number": "Numéro de téléphone",

package/admin/i18n/it.json

@@ -7,7 +7,6 @@
 	"Region": "Regione",
 	"European Union": "Unione europea",
 	"Rest of World": "Resto del mondo",
-	"Cloud connectivity is not implemented yet. This value does not select a working backend.": "La connessione cloud non è ancora implementata. Questo valore non seleziona un servizio funzionante.",
 	"Login type": "Tipo di accesso",
 	"Email": "E-mail",
 	"Phone number": "Numero di telefono",

package/admin/i18n/nl.json

@@ -7,7 +7,6 @@
 	"Region": "Regio",
 	"European Union": "Europese Unie",
 	"Rest of World": "Rest van de wereld",
-	"Cloud connectivity is not implemented yet. This value does not select a working backend.": "Cloudverbinding is nog niet geïmplementeerd. Deze waarde selecteert geen werkende backend.",
 	"Login type": "Aanmeldtype",
 	"Email": "E-mailadres",
 	"Phone number": "Telefoonnummer",

package/admin/i18n/pl.json

@@ -7,7 +7,6 @@
 	"Region": "Region",
 	"European Union": "Unia Europejska",
 	"Rest of World": "Reszta świata",
-	"Cloud connectivity is not implemented yet. This value does not select a working backend.": "Połączenie z chmurą nie jest jeszcze zaimplementowane. Ta wartość nie wybiera działającej usługi.",
 	"Login type": "Typ logowania",
 	"Email": "E-mail",
 	"Phone number": "Numer telefonu",

package/admin/i18n/pt.json

@@ -7,7 +7,6 @@
 	"Region": "Região",
 	"European Union": "União Europeia",
 	"Rest of World": "Resto do mundo",
-	"Cloud connectivity is not implemented yet. This value does not select a working backend.": "A ligação à nuvem ainda não está implementada. Este valor não seleciona um serviço funcional.",
 	"Login type": "Tipo de início de sessão",
 	"Email": "E-mail",
 	"Phone number": "Número de telefone",

package/admin/i18n/ru.json

@@ -7,7 +7,6 @@
 	"Region": "Регион",
 	"European Union": "Европейский союз",
 	"Rest of World": "Остальной мир",
-	"Cloud connectivity is not implemented yet. This value does not select a working backend.": "Подключение к облаку пока не реализовано. Это значение не выбирает работающий сервер.",
 	"Login type": "Тип входа",
 	"Email": "Электронная почта",
 	"Phone number": "Номер телефона",

package/admin/i18n/uk.json

@@ -7,7 +7,6 @@
 	"Region": "Регіон",
 	"European Union": "Європейський Союз",
 	"Rest of World": "Решта світу",
-	"Cloud connectivity is not implemented yet. This value does not select a working backend.": "Підключення до хмари ще не реалізовано. Це значення не вибирає робочий сервер.",
 	"Login type": "Тип входу",
 	"Email": "Електронна пошта",
 	"Phone number": "Номер телефону",

package/admin/i18n/zh-cn.json

@@ -7,7 +7,6 @@
 	"Region": "地区",
 	"European Union": "欧盟",
 	"Rest of World": "其他地区",
-	"Cloud connectivity is not implemented yet. This value does not select a working backend.": "云连接尚未实现。此选项不会选择可用的后端服务。",
 	"Login type": "登录类型",
 	"Email": "电子邮箱",
 	"Phone number": "电话号码",

package/admin/jsonConfig.json

@@ -110,7 +110,8 @@
 					"type": "number",
 					"label": "Status polling interval (seconds)",
 					"default": 1800,
-					"min": 1,
+					"min": 60,
+					"max": 2147483,
 					"step": 1,
 					"xs": 12,
 					"sm": 12,

package/build/config.js

@@ -19,16 +19,18 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var config_exports = {};
 __export(config_exports, {
   DEFAULT_POLL_INTERVAL_SECONDS: () => DEFAULT_POLL_INTERVAL_SECONDS,
+  MAX_POLL_INTERVAL_SECONDS: () => MAX_POLL_INTERVAL_SECONDS,
   validateConfig: () => validateConfig
 });
 module.exports = __toCommonJS(config_exports);
 var import_regions = require("./regions");
 const DEFAULT_POLL_INTERVAL_SECONDS = 1800;
+const MAX_POLL_INTERVAL_SECONDS = 2147483;
 function validateConfig(config) {
   var _a, _b, _c;
   const errors = [];
-  if (config.pollIntervalSeconds !== void 0 && (!Number.isInteger(config.pollIntervalSeconds) || config.pollIntervalSeconds < 1)) {
-    errors.push("Polling interval must be a positive integer number of seconds");
+  if (config.pollIntervalSeconds !== void 0 && (!Number.isInteger(config.pollIntervalSeconds) || config.pollIntervalSeconds < 60 || config.pollIntervalSeconds > MAX_POLL_INTERVAL_SECONDS)) {
+    errors.push(`Polling interval must be an integer between 60 and ${MAX_POLL_INTERVAL_SECONDS} seconds`);
   }
   if (!((_a = config.region) == null ? void 0 : _a.trim())) {
     errors.push("Region/backend code is required");
@@ -54,6 +56,7 @@ function validateConfig(config) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_POLL_INTERVAL_SECONDS,
+  MAX_POLL_INTERVAL_SECONDS,
   validateConfig
 });
 //# sourceMappingURL=config.js.map

package/build/config.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/config.ts"],
-  "sourcesContent": ["import { isIndiaRegion, resolveSaicRegion } from './regions';\n\n/** Settings entered for one iSmart account and backend. */\nexport interface MgSaicConfig {\n\t/** Automatic status polling interval in seconds. */\n\tpollIntervalSeconds?: number;\n\t/** Backend region code. */\n\tregion?: string;\n\t/** Whether the account identifier is an email address or phone number. */\n\taccountType?: string;\n\t/** Email address or phone number used to sign in. */\n\taccountIdentifier?: string;\n\t/** International calling code when using a phone account. */\n\tphoneCountryCode?: string;\n\t/** Account password, decrypted by ioBroker for the adapter process. */\n\tpassword?: string;\n}\n\nexport const DEFAULT_POLL_INTERVAL_SECONDS = 1800;\n\n/**\n * Returns configuration problems without logging any credential values.\n *\n * @param config The instance's native configuration.\n */\nexport function validateConfig(config: MgSaicConfig): string[] {\n\tconst errors: string[] = [];\n\tif (\n\t\tconfig.pollIntervalSeconds !== undefined &&\n\t\t(!Number.isInteger(config.pollIntervalSeconds) || config.pollIntervalSeconds < 1)\n\t) {\n\t\terrors.push('Polling interval must be a positive integer number of seconds');\n\t}\n\tif (!config.region?.trim()) {\n\t\terrors.push('Region/backend code is required');\n\t} else if (isIndiaRegion(config.region)) {\n\t\terrors.push('India TAP connectivity is not implemented yet');\n\t} else if (!resolveSaicRegion(config.region)) {\n\t\terrors.push('Unsupported SAIC region');\n\t}\n\tif (config.accountType !== 'email' && config.accountType !== 'phone') {\n\t\terrors.push('Login type must be email or phone');\n\t}\n\tif (!config.accountIdentifier?.trim()) {\n\t\terrors.push('Email address or phone number is required');\n\t}\n\tif (config.accountType === 'phone' && !config.phoneCountryCode?.trim()) {\n\t\terrors.push('Phone country calling code is required');\n\t}\n\tif (!config.password) {\n\t\terrors.push('Password is required');\n\t}\n\treturn errors;\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAiD;AAkB1C,MAAM,gCAAgC;AAOtC,SAAS,eAAe,QAAgC;AAzB/D;AA0BC,QAAM,SAAmB,CAAC;AAC1B,MACC,OAAO,wBAAwB,WAC9B,CAAC,OAAO,UAAU,OAAO,mBAAmB,KAAK,OAAO,sBAAsB,IAC9E;AACD,WAAO,KAAK,+DAA+D;AAAA,EAC5E;AACA,MAAI,GAAC,YAAO,WAAP,mBAAe,SAAQ;AAC3B,WAAO,KAAK,iCAAiC;AAAA,EAC9C,eAAW,8BAAc,OAAO,MAAM,GAAG;AACxC,WAAO,KAAK,+CAA+C;AAAA,EAC5D,WAAW,KAAC,kCAAkB,OAAO,MAAM,GAAG;AAC7C,WAAO,KAAK,yBAAyB;AAAA,EACtC;AACA,MAAI,OAAO,gBAAgB,WAAW,OAAO,gBAAgB,SAAS;AACrE,WAAO,KAAK,mCAAmC;AAAA,EAChD;AACA,MAAI,GAAC,YAAO,sBAAP,mBAA0B,SAAQ;AACtC,WAAO,KAAK,2CAA2C;AAAA,EACxD;AACA,MAAI,OAAO,gBAAgB,WAAW,GAAC,YAAO,qBAAP,mBAAyB,SAAQ;AACvE,WAAO,KAAK,wCAAwC;AAAA,EACrD;AACA,MAAI,CAAC,OAAO,UAAU;AACrB,WAAO,KAAK,sBAAsB;AAAA,EACnC;AACA,SAAO;AACR;",
+  "sourcesContent": ["import { isIndiaRegion, resolveSaicRegion } from './regions';\n\n/** Settings entered for one iSmart account and backend. */\nexport interface MgSaicConfig {\n\t/** Automatic status polling interval in seconds. */\n\tpollIntervalSeconds?: number;\n\t/** Backend region code. */\n\tregion?: string;\n\t/** Whether the account identifier is an email address or phone number. */\n\taccountType?: string;\n\t/** Email address or phone number used to sign in. */\n\taccountIdentifier?: string;\n\t/** International calling code when using a phone account. */\n\tphoneCountryCode?: string;\n\t/** Account password, decrypted by ioBroker for the adapter process. */\n\tpassword?: string;\n}\n\nexport const DEFAULT_POLL_INTERVAL_SECONDS = 1800;\nexport const MAX_POLL_INTERVAL_SECONDS = 2_147_483;\n\n/**\n * Returns configuration problems without logging any credential values.\n *\n * @param config The instance's native configuration.\n */\nexport function validateConfig(config: MgSaicConfig): string[] {\n\tconst errors: string[] = [];\n\tif (\n\t\tconfig.pollIntervalSeconds !== undefined &&\n\t\t(!Number.isInteger(config.pollIntervalSeconds) ||\n\t\t\tconfig.pollIntervalSeconds < 60 ||\n\t\t\tconfig.pollIntervalSeconds > MAX_POLL_INTERVAL_SECONDS)\n\t) {\n\t\terrors.push(`Polling interval must be an integer between 60 and ${MAX_POLL_INTERVAL_SECONDS} seconds`);\n\t}\n\tif (!config.region?.trim()) {\n\t\terrors.push('Region/backend code is required');\n\t} else if (isIndiaRegion(config.region)) {\n\t\terrors.push('India TAP connectivity is not implemented yet');\n\t} else if (!resolveSaicRegion(config.region)) {\n\t\terrors.push('Unsupported SAIC region');\n\t}\n\tif (config.accountType !== 'email' && config.accountType !== 'phone') {\n\t\terrors.push('Login type must be email or phone');\n\t}\n\tif (!config.accountIdentifier?.trim()) {\n\t\terrors.push('Email address or phone number is required');\n\t}\n\tif (config.accountType === 'phone' && !config.phoneCountryCode?.trim()) {\n\t\terrors.push('Phone country calling code is required');\n\t}\n\tif (!config.password) {\n\t\terrors.push('Password is required');\n\t}\n\treturn errors;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAiD;AAkB1C,MAAM,gCAAgC;AACtC,MAAM,4BAA4B;AAOlC,SAAS,eAAe,QAAgC;AA1B/D;AA2BC,QAAM,SAAmB,CAAC;AAC1B,MACC,OAAO,wBAAwB,WAC9B,CAAC,OAAO,UAAU,OAAO,mBAAmB,KAC5C,OAAO,sBAAsB,MAC7B,OAAO,sBAAsB,4BAC7B;AACD,WAAO,KAAK,sDAAsD,yBAAyB,UAAU;AAAA,EACtG;AACA,MAAI,GAAC,YAAO,WAAP,mBAAe,SAAQ;AAC3B,WAAO,KAAK,iCAAiC;AAAA,EAC9C,eAAW,8BAAc,OAAO,MAAM,GAAG;AACxC,WAAO,KAAK,+CAA+C;AAAA,EAC5D,WAAW,KAAC,kCAAkB,OAAO,MAAM,GAAG;AAC7C,WAAO,KAAK,yBAAyB;AAAA,EACtC;AACA,MAAI,OAAO,gBAAgB,WAAW,OAAO,gBAAgB,SAAS;AACrE,WAAO,KAAK,mCAAmC;AAAA,EAChD;AACA,MAAI,GAAC,YAAO,sBAAP,mBAA0B,SAAQ;AACtC,WAAO,KAAK,2CAA2C;AAAA,EACxD;AACA,MAAI,OAAO,gBAAgB,WAAW,GAAC,YAAO,qBAAP,mBAAyB,SAAQ;AACvE,WAAO,KAAK,wCAAwC;AAAA,EACrD;AACA,MAAI,CAAC,OAAO,UAAU;AACrB,WAAO,KAAK,sBAAsB;AAAA,EACnC;AACA,SAAO;AACR;",
   "names": []
 }