iobroker.fairland 0.2.1

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 dude2k
+Portions derived from ha-fairland:
+Copyright (c) 2025 @siedi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,219 @@
+# ioBroker Fairland Adapter
+
+Unofficial ioBroker adapter for Fairland pool heat pumps and pool pumps that
+use the Fairland **iGarden** cloud API.
+
+This adapter talks directly to the iGarden cloud. It does not use Tuya and it
+does not support Fairland devices paired through the SmartPool app.
+
+## Supported devices
+
+- Fairland pool heat pumps on the iGarden platform
+- Fairland Inverflow Plus pool pumps on the iGarden platform
+- OEM-rebadged iGarden devices, for example Madimack pool pumps
+
+The adapter currently knows the device categories `heatPump` and `waterPump`.
+Unknown categories are logged and skipped.
+
+This project is not affiliated with, endorsed by, or supported by Fairland,
+Home Assistant, ioBroker, or the upstream ha-fairland project maintainers.
+
+## Installation
+
+This adapter is not published to npm or the official ioBroker repository yet.
+Installation instructions will be added after the adapter is published.
+
+## Requirements
+
+- Node.js 22 or newer
+- ioBroker js-controller 6.0.11 or newer
+- ioBroker Admin 7.8.23 or newer
+
+For local development:
+
+```bash
+npm run build
+```
+
+Additional development commands:
+
+```bash
+npm run lint
+npm run translate
+npm run release
+```
+
+## Configuration
+
+The instance configuration contains:
+
+- `iGarden account e-mail`: account name used in the iGarden app
+- `iGarden password`: account password
+- `Scan interval`: polling interval in seconds, minimum 10 seconds
+- `Courtyard ID`: optional. Leave empty to use the first courtyard returned by
+  the cloud. If the account has several courtyards, the adapter logs all IDs.
+- `Create raw dpId states`: optional diagnostic states under
+  `devices.<device>.raw.dp_<id>`
+
+The adapter automatically detects the correct regional API server:
+
+- EU: `api-eu.fairlandiot.com`
+- US: `api-us.fairlandiot.com`
+- CN: `api-cn.fairlandiot.com`
+- HK: `api-hk.fairlandiot.com`
+
+## Important iGarden limitation
+
+The iGarden cloud usually allows only one active session per account. If the
+adapter is logged in, the iGarden mobile app may show the device as offline, and
+the reverse can also happen.
+
+Recommended workaround: create a second iGarden account, share the device to
+that account in the iGarden app, and configure ioBroker with the second account.
+
+## State structure
+
+Devices are created below:
+
+```text
+fairland.0.devices.<deviceId>
+```
+
+Common states:
+
+```text
+info.name
+info.category
+info.version
+power
+mode
+```
+
+Heat pump states include:
+
+```text
+temperature.current
+temperature.target
+temperature.outlet
+temperature.ambient
+power.current
+presetMode
+hvac.action
+config.*
+diagnostic.*
+```
+
+Water pump states include:
+
+```text
+pump.speedSetpoint
+pump.runningRate
+pump.backwashDuration
+pump.backwashCountdown
+power.current
+energy.consumption
+mode
+```
+
+Writable states are mapped back to the correct Fairland `dpId`. The adapter keeps
+optimistic values for a short period after writes because the iGarden cloud can
+take a few seconds to report newly written values back.
+
+## Development notes
+
+The implementation is a TypeScript port of the Home Assistant Fairland/iGarden
+integration logic:
+
+- cloud login and automatic regional server detection
+- courtyard and device discovery
+- category-specific `dpId` mappings
+- scale and unit parsing from `dpProperty`
+- optimistic write handling
+
+Build:
+
+```bash
+npm run build
+```
+
+The compiled adapter entry point is `build/main.js`.
+
+## Attribution
+
+This adapter is derived from the MIT-licensed Home Assistant Fairland
+integration by @siedi:
+
+```text
+https://github.com/siedi/ha-fairland
+```
+
+The original project license notice is preserved in `LICENSE`, and additional
+third-party notices are listed in `THIRD_PARTY_NOTICES.md`.
+
+## Changelog
+
+### 0.2.1
+
+- Skip the npm deploy job until npm publishing is explicitly enabled for the repository.
+
+### 0.2.0
+
+- Added Dependabot update configuration and Dependabot auto-merge workflow.
+- Added Node.js 22 TypeScript base configuration.
+- Raised the minimum ioBroker Admin requirement to 7.8.23.
+
+### 0.1.8
+
+- Updated TypeScript to 6.0.3.
+- Adjusted the TypeScript configuration for TypeScript 6.
+- Added `CHANGELOG_OLD.md` for older changelog entries.
+
+### 0.1.7
+
+- Aligned Node.js type definitions with the supported Node.js 22 runtime.
+
+### 0.1.6
+
+- Completed admin UI i18n files for all standard ioBroker languages.
+
+### 0.1.5
+
+- Added the standard GitHub Actions test and release workflow.
+- Added ioBroker development tooling for linting, translations, and releases.
+- Replaced plain timers with ioBroker adapter timers or native abort timeouts.
+- Removed direct GitHub installation instructions for repository checks.
+
+### 0.1.4
+
+- Added an adapter icon.
+- Completed `io-package.json` translations for repository checks.
+
+### 0.1.3
+
+- Raised the minimum Node.js version to 22.
+- Added `@iobroker/testing` as a development dependency.
+- Updated package keywords for ioBroker repository checks.
+
+### 0.1.2
+
+- Fixed `diagnostic.powerDisplayStatus` state type for boolean Fairland API values.
+
+### 0.1.1
+
+- Fixed ioBroker package schema for GitHub installation.
+- Added upstream license attribution and third-party notices.
+
+### 0.1.0
+
+- Initial ioBroker port of the Fairland iGarden integration.
+
+Older changelog entries may be moved to [CHANGELOG_OLD.md](CHANGELOG_OLD.md).
+
+## License
+
+MIT.
+
+Copyright (c) 2026 dude2k.
+Portions derived from ha-fairland: Copyright (c) 2025 @siedi.
+
+See `LICENSE` for details.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,37 @@
+# Third-Party Notices
+
+## ha-fairland
+
+This ioBroker adapter is derived from the MIT-licensed Home Assistant Fairland
+integration:
+
+```text
+Project: ha-fairland
+Repository: https://github.com/siedi/ha-fairland
+Copyright (c) 2025 @siedi
+License: MIT
+```
+
+The upstream project provides Fairland/iGarden cloud API behavior, regional
+server detection, device category handling, data point mappings, scale/unit
+handling, and optimistic write behavior that were ported and adapted for
+ioBroker.
+
+## Runtime dependencies
+
+Direct runtime dependency:
+
+```text
+@iobroker/adapter-core
+License: MIT
+```
+
+Development dependencies:
+
+```text
+typescript
+License: Apache-2.0
+
+@types/node
+License: MIT
+```

package/admin/i18n/de/translations.json

@@ -0,0 +1,9 @@
+{
+  "iGarden account e-mail": "iGarden Account-E-Mail",
+  "iGarden password": "iGarden Passwort",
+  "Scan interval in seconds": "Abfrageintervall in Sekunden",
+  "Courtyard ID (optional)": "Courtyard-ID (optional)",
+  "Create raw dpId states": "Raw-dpId-States erstellen",
+  "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.": "Leer lassen, um den ersten von der iGarden-Cloud gelieferten Hof zu verwenden. Bei mehreren Hoefen die gewuenschte ID aus dem Adapter-Log eintragen.",
+  "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics.": "Erstellt Raw-States unter devices.<device>.raw.dp_<id>. Schreibbare Raw-States folgen dem Cloud-dpMode und sind fuer Diagnosen hilfreich."
+}

package/admin/i18n/en/translations.json

@@ -0,0 +1,9 @@
+{
+  "iGarden account e-mail": "iGarden account e-mail",
+  "iGarden password": "iGarden password",
+  "Scan interval in seconds": "Scan interval in seconds",
+  "Courtyard ID (optional)": "Courtyard ID (optional)",
+  "Create raw dpId states": "Create raw dpId states",
+  "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.": "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.",
+  "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics.": "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics."
+}

package/admin/i18n/es/translations.json

@@ -0,0 +1,9 @@
+{
+  "iGarden account e-mail": "Correo electronico de la cuenta iGarden",
+  "iGarden password": "Contrasena de iGarden",
+  "Scan interval in seconds": "Intervalo de consulta en segundos",
+  "Courtyard ID (optional)": "ID del patio (opcional)",
+  "Create raw dpId states": "Crear estados dpId sin procesar",
+  "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.": "Dejelo vacio para usar el primer patio devuelto por la nube iGarden. Si tiene varios patios, introduzca el ID deseado desde el registro del adaptador.",
+  "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics.": "Crea estados sin procesar bajo devices.<device>.raw.dp_<id>. Los estados sin procesar escribibles siguen el dpMode de la nube y son utiles para diagnosticos."
+}

package/admin/i18n/fr/translations.json

@@ -0,0 +1,9 @@
+{
+  "iGarden account e-mail": "E-mail du compte iGarden",
+  "iGarden password": "Mot de passe iGarden",
+  "Scan interval in seconds": "Intervalle d'interrogation en secondes",
+  "Courtyard ID (optional)": "ID de cour (facultatif)",
+  "Create raw dpId states": "Creer les etats dpId bruts",
+  "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.": "Laissez vide pour utiliser la premiere cour renvoyee par le cloud iGarden. Si vous avez plusieurs cours, indiquez l'ID souhaite depuis le journal de l'adaptateur.",
+  "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics.": "Cree des etats bruts sous devices.<device>.raw.dp_<id>. Les etats bruts modifiables suivent le dpMode du cloud et sont utiles pour le diagnostic."
+}

package/admin/i18n/it/translations.json

@@ -0,0 +1,9 @@
+{
+  "iGarden account e-mail": "E-mail dell'account iGarden",
+  "iGarden password": "Password iGarden",
+  "Scan interval in seconds": "Intervallo di scansione in secondi",
+  "Courtyard ID (optional)": "ID cortile (opzionale)",
+  "Create raw dpId states": "Crea stati dpId grezzi",
+  "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.": "Lasciare vuoto per usare il primo cortile restituito dal cloud iGarden. Se ci sono piu cortili, impostare l'ID desiderato dal log dell'adapter.",
+  "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics.": "Crea stati grezzi sotto devices.<device>.raw.dp_<id>. Gli stati grezzi scrivibili seguono il dpMode del cloud e sono utili per la diagnostica."
+}

package/admin/i18n/nl/translations.json

@@ -0,0 +1,9 @@
+{
+  "iGarden account e-mail": "E-mail van iGarden-account",
+  "iGarden password": "iGarden-wachtwoord",
+  "Scan interval in seconds": "Scaninterval in seconden",
+  "Courtyard ID (optional)": "Binnenplaats-ID (optioneel)",
+  "Create raw dpId states": "Ruwe dpId-statussen maken",
+  "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.": "Laat leeg om de eerste binnenplaats te gebruiken die door de iGarden-cloud wordt teruggegeven. Als u meerdere binnenplaatsen hebt, stelt u de gewenste ID uit het adapterlog in.",
+  "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics.": "Maakt ruwe statussen onder devices.<device>.raw.dp_<id>. Schrijfbare ruwe statussen volgen de cloud-dpMode en zijn nuttig voor diagnose."
+}

package/admin/i18n/pl/translations.json

@@ -0,0 +1,9 @@
+{
+  "iGarden account e-mail": "E-mail konta iGarden",
+  "iGarden password": "Haslo iGarden",
+  "Scan interval in seconds": "Interwal odpytywania w sekundach",
+  "Courtyard ID (optional)": "ID dziedzinca (opcjonalnie)",
+  "Create raw dpId states": "Utworz surowe stany dpId",
+  "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.": "Pozostaw puste, aby uzyc pierwszego dziedzinca zwroconego przez chmure iGarden. Jesli masz kilka dziedzincow, ustaw wybrane ID z logu adaptera.",
+  "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics.": "Tworzy surowe stany pod devices.<device>.raw.dp_<id>. Zapisywalne surowe stany sa zgodne z cloud dpMode i sa przydatne do diagnostyki."
+}

package/admin/i18n/pt/translations.json

@@ -0,0 +1,9 @@
+{
+  "iGarden account e-mail": "E-mail da conta iGarden",
+  "iGarden password": "Senha do iGarden",
+  "Scan interval in seconds": "Intervalo de consulta em segundos",
+  "Courtyard ID (optional)": "ID do patio (opcional)",
+  "Create raw dpId states": "Criar estados dpId brutos",
+  "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.": "Deixe vazio para usar o primeiro patio retornado pela nuvem iGarden. Se houver varios patios, defina o ID desejado a partir do log do adaptador.",
+  "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics.": "Cria estados brutos em devices.<device>.raw.dp_<id>. Estados brutos gravaveis seguem o dpMode da nuvem e sao uteis para diagnosticos."
+}

package/admin/i18n/ru/translations.json

@@ -0,0 +1,9 @@
+{
+  "iGarden account e-mail": "E-mail uchetnoy zapisi iGarden",
+  "iGarden password": "Parol iGarden",
+  "Scan interval in seconds": "Interval oprosa v sekundah",
+  "Courtyard ID (optional)": "ID dvora (neobyazatelno)",
+  "Create raw dpId states": "Sozdavat syrye sostoyaniya dpId",
+  "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.": "Ostavte pustym, chtoby ispolzovat pervyy dvor, vozvrashchennyy oblakom iGarden. Esli dvorov neskolko, ukazhite nuzhnyy ID iz zhurnala adaptera.",
+  "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics.": "Sozdaet syrye sostoyaniya v devices.<device>.raw.dp_<id>. Dostupnye dlya zapisi syrye sostoyaniya sleduyut oblachnomu dpMode i polezny dlya diagnostiki."
+}

package/admin/i18n/uk/translations.json

@@ -0,0 +1,9 @@
+{
+  "iGarden account e-mail": "E-mail oblikovoho zapysu iGarden",
+  "iGarden password": "Parol iGarden",
+  "Scan interval in seconds": "Interval opytuvannia v sekundakh",
+  "Courtyard ID (optional)": "ID dvoru (neoboviazkovo)",
+  "Create raw dpId states": "Stvoriuvaty syri stany dpId",
+  "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.": "Zalyshte porozhnim, shchob vykorystaty pershyi dvir, povernanyi khmaroiu iGarden. Yakshcho dvoriv kilka, vstanovit potribnyi ID z zhurnalu adaptera.",
+  "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics.": "Stvoriuie syri stany u devices.<device>.raw.dp_<id>. Zapysuvani syri stany vidpovidaiut khmarnomu dpMode i korysni dlia diahnostyky."
+}

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

@@ -0,0 +1,9 @@
+{
+  "iGarden account e-mail": "iGarden 账户电子邮件",
+  "iGarden password": "iGarden 密码",
+  "Scan interval in seconds": "扫描间隔（秒）",
+  "Courtyard ID (optional)": "庭院 ID（可选）",
+  "Create raw dpId states": "创建原始 dpId 状态",
+  "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.": "留空则使用 iGarden 云返回的第一个庭院。如果有多个庭院，请从适配器日志中设置所需的 ID。",
+  "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics.": "在 devices.<device>.raw.dp_<id> 下创建原始状态。可写原始状态遵循云端 dpMode，可用于诊断。"
+}

package/admin/jsonConfig.json

@@ -0,0 +1,59 @@
+{
+  "type": "panel",
+  "i18n": true,
+  "items": {
+    "accountName": {
+      "type": "text",
+      "label": "iGarden account e-mail",
+      "xs": 12,
+      "sm": 6,
+      "md": 6,
+      "lg": 6,
+      "xl": 6,
+      "newLine": true
+    },
+    "password": {
+      "type": "password",
+      "label": "iGarden password",
+      "xs": 12,
+      "sm": 6,
+      "md": 6,
+      "lg": 6,
+      "xl": 6
+    },
+    "scanInterval": {
+      "type": "number",
+      "label": "Scan interval in seconds",
+      "min": 10,
+      "max": 3600,
+      "xs": 12,
+      "sm": 6,
+      "md": 6,
+      "lg": 6,
+      "xl": 6,
+      "default": 30,
+      "newLine": true
+    },
+    "courtyardId": {
+      "type": "text",
+      "label": "Courtyard ID (optional)",
+      "help": "Leave empty to use the first courtyard returned by the iGarden cloud. If you have several courtyards, set the desired ID from the adapter log.",
+      "xs": 12,
+      "sm": 6,
+      "md": 6,
+      "lg": 6,
+      "xl": 6
+    },
+    "createRawStates": {
+      "type": "checkbox",
+      "label": "Create raw dpId states",
+      "help": "Creates raw states under devices.<device>.raw.dp_<id>. Writable raw states follow the cloud dpMode and are useful for diagnostics.",
+      "xs": 12,
+      "sm": 6,
+      "md": 6,
+      "lg": 6,
+      "xl": 6,
+      "newLine": true
+    }
+  }
+}

package/build/dpUtils.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDpProperty = parseDpProperty;
+exports.getDpScale = getDpScale;
+exports.scaleRead = scaleRead;
+exports.scaleWrite = scaleWrite;
+exports.applyDpProperty = applyDpProperty;
+exports.parseEnumOptions = parseEnumOptions;
+exports.toStatesObject = toStatesObject;
+exports.invertEnum = invertEnum;
+exports.sanitizeObjectId = sanitizeObjectId;
+exports.toStateValue = toStateValue;
+exports.inferStateType = inferStateType;
+exports.coerceStateValue = coerceStateValue;
+exports.valuesMatch = valuesMatch;
+const TIME_UNIT_MAP = {
+    s: 's',
+    min: 'min',
+};
+function parseDpProperty(dp) {
+    if (typeof dp.dpProperty !== 'string' || dp.dpProperty.trim() === '') {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(dp.dpProperty);
+        return isRecord(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function getDpScale(dp, fallback = 0) {
+    const prop = parseDpProperty(dp);
+    const scale = prop.scale;
+    if (typeof scale === 'number' && Number.isFinite(scale)) {
+        return scale;
+    }
+    if (typeof scale === 'string' && scale.trim() !== '') {
+        const parsed = Number(scale);
+        return Number.isFinite(parsed) ? parsed : fallback;
+    }
+    return fallback;
+}
+function scaleRead(value, scale) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (scale > 0 && typeof value === 'number') {
+        return value / 10 ** scale;
+    }
+    return toStateValue(value);
+}
+function scaleWrite(value, scale) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (scale > 0 && typeof value === 'number') {
+        return Math.round(value * 10 ** scale);
+    }
+    return value;
+}
+function applyDpProperty(definition, dp) {
+    const prop = parseDpProperty(dp);
+    const next = { ...definition };
+    if (definition.useDpScale) {
+        next.scale = getDpScale(dp, definition.scale ?? 0);
+    }
+    if (definition.useDpRange) {
+        if (prop.min !== undefined) {
+            const min = Number(prop.min);
+            if (Number.isFinite(min)) {
+                next.min = min;
+            }
+        }
+        if (prop.max !== undefined) {
+            const max = Number(prop.max);
+            if (Number.isFinite(max)) {
+                next.max = max;
+            }
+        }
+        if (prop.step !== undefined) {
+            const step = Number(prop.step);
+            if (Number.isFinite(step) && step > 0) {
+                next.step = step;
+            }
+        }
+    }
+    if (definition.useDpTimeUnit && typeof prop.unit === 'string' && TIME_UNIT_MAP[prop.unit]) {
+        next.unit = TIME_UNIT_MAP[prop.unit];
+    }
+    return next;
+}
+function parseEnumOptions(dp, fallback, labelToOption) {
+    const prop = parseDpProperty(dp);
+    const options = {};
+    for (const [raw, label] of Object.entries(prop)) {
+        const value = Number(raw);
+        if (!Number.isInteger(value)) {
+            continue;
+        }
+        const text = String(label);
+        options[value] = labelToOption[text] ?? slugify(text);
+    }
+    return Object.keys(options).length > 0 ? options : { ...fallback };
+}
+function toStatesObject(options) {
+    return Object.fromEntries(Object.values(options).map(option => [option, humanize(option)]));
+}
+function invertEnum(options) {
+    return Object.fromEntries(Object.entries(options).map(([raw, option]) => [option, Number(raw)]));
+}
+function sanitizeObjectId(value) {
+    const sanitized = String(value)
+        .trim()
+        .replace(/[.\s]+/g, '_')
+        .replace(/[^A-Za-z0-9_-]/g, '_')
+        .replace(/_+/g, '_')
+        .replace(/^_+|_+$/g, '');
+    return sanitized || 'unknown';
+}
+function toStateValue(value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return value;
+    }
+    return JSON.stringify(value);
+}
+function inferStateType(value) {
+    if (typeof value === 'boolean') {
+        return 'boolean';
+    }
+    if (typeof value === 'number') {
+        return 'number';
+    }
+    if (typeof value === 'string') {
+        return 'string';
+    }
+    return 'mixed';
+}
+function coerceStateValue(value, type) {
+    if (value === undefined || value === null || type === 'mixed' || type === undefined) {
+        return value ?? null;
+    }
+    if (type === 'boolean') {
+        if (typeof value === 'boolean') {
+            return value;
+        }
+        if (typeof value === 'number') {
+            return value !== 0;
+        }
+        return ['true', '1', 'on', 'yes'].includes(value.toLowerCase());
+    }
+    if (type === 'number') {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    return String(value);
+}
+function valuesMatch(a, b) {
+    const aNumber = Number(a);
+    const bNumber = Number(b);
+    if (Number.isFinite(aNumber) && Number.isFinite(bNumber)) {
+        return aNumber === bNumber;
+    }
+    return String(a) === String(b);
+}
+function slugify(value) {
+    const slug = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+    return slug || 'unknown';
+}
+function humanize(value) {
+    return value
+        .split('_')
+        .filter(Boolean)
+        .map(part => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(' ');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}