homebridge-omnilogic-pool 0.1.0-beta.1

package/CHANGELOG.md

@@ -0,0 +1,72 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0-beta.1] - 2026-05-11
+
+First public beta. Published under the `beta` dist-tag while real-world
+firmware coverage is gathered; install with
+`npm install homebridge-omnilogic-pool@beta`.
+
+### Added
+
+- Test suite (`node:test` via `tsx`) covering the XML/SOAP helpers
+  (redaction, parser variants, topology builder, telemetry indexing,
+  auth-failure detection) and `TokenStore` (file mode, round-trip,
+  expiry, wrong-user rejection, corrupted file, atomic write). `npm
+  test` runs locally and on CI for every Node version in the matrix.
+- `publish.yml` accepts a `workflow_dispatch` with a `dry-run` boolean
+  input so the publish workflow can be exercised end-to-end without
+  pushing to npm.
+- Disk-backed token cache (`omnilogic-token.json` in Homebridge's plugin
+  persist path) so the plugin doesn't re-authenticate on every Homebridge
+  restart. Stored with `0600` file permissions and bound to the configured
+  username.
+- `hideEquipmentIds` config option to suppress specific accessories without
+  disabling whole categories.
+- `disableLogs` config option for users who want a fully quiet plugin.
+- Discovery is now retried with exponential backoff (5s → 5min) when the
+  cloud is unreachable at startup, instead of failing the plugin permanently.
+- Discovered equipment is logged at startup with system IDs so users can
+  pick IDs to hide via `hideEquipmentIds`.
+- Bug-report issue template (`.github/ISSUE_TEMPLATE/bug_report.yml`).
+
+### Changed
+
+- Extracted pure XML/SOAP helpers from `omnilogic-api.ts` into a new
+  `xml-utils.ts` module. `OmniLogicApi` is now ~40% smaller and
+  focused on transport + token state; the parsing logic is testable
+  in isolation. No behaviour change for consumers.
+- Collapsed five duplicated `try { setX(); refresh } catch { log; throw }`
+  blocks across the accessory files into a single `BaseAccessory.runApiSet`
+  helper.
+- Pulled the 8-parameter "no schedule" trailing block out of three SET
+  methods into a shared `NO_SCHEDULE` constant.
+- ESLint rule `quotes` allows template literals (`avoidEscape` only
+  covered double quotes).
+- `engines.node` bumped to `^20.10.0 || ^22 || ^24`. Node 18 is no longer
+  supported.
+- Dev tooling: dropped `nodemon` in favour of `tsc --watch` + Node's own
+  `--watch` flag, orchestrated by `concurrently`.
+- Publish workflow uses `NPM_CONFIG_PROVENANCE` env var instead of the
+  `--provenance` flag (functionally identical).
+- README restructured to lead with troubleshooting and quick-start.
+
+## [0.1.0] - Initial release
+
+- TypeScript dynamic platform plugin for Hayward OmniLogic.
+- SOAP/XML client for `HomeAutomationService.asmx` with redacted debug
+  logs, nested-XML payload parsing, Status validation on SETs, transparent
+  re-login on token expiry.
+- Accessory handlers: Heater (Thermostat), variable-speed Filter (Fan),
+  pumps/chlorinator (Switch), ColorLogic lights (Lightbulb), water
+  temperature (Temperature Sensor).
+- Per-accessory SET mutex and post-SET telemetry refresh for a responsive
+  HomeKit experience.
+- GitHub Actions CI on Node 18/20/22 (later moved to 20/22/24) and
+  tag-driven npm publish workflow with provenance.

package/LICENSE

@@ -0,0 +1,20 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+   Copyright 2026 kzaky
+
+   The full text of the Apache License 2.0 is available at
+   http://www.apache.org/licenses/LICENSE-2.0

package/README.md

@@ -0,0 +1,187 @@
+# homebridge-omnilogic-pool
+
+A modern [Homebridge](https://homebridge.io) plugin for the
+**Hayward OmniLogic** pool/spa controller.
+
+Supports Node 20 / 22 / 24 and Homebridge 1.8+ / 2.0. Replaces the
+unmaintained `homebridge-omnilogic` plugin which only ran on legacy
+Node versions.
+
+> **Status:** unofficial, community-built, not endorsed by Hayward.
+
+## Troubleshooting first
+
+Most setup problems fall into one of these:
+
+| Symptom | Likely cause | Fix |
+| --- | --- | --- |
+| `login failed (Status=…)` | Wrong credentials, or account doesn't have access to the site | Verify in the OmniLogic mobile app, then update `username`/`password` |
+| Plugin loads but no accessories appear | MSP config response was empty | Enable `"debug": true`, restart, attach the redacted `GetMspConfigFile` log section to a GitHub issue |
+| HomeKit shows the wrong on/off state | Telemetry attribute names differ for your firmware | Open an issue with the redacted `GetTelemetryData` response |
+| Heater set rejected (`Status=…`) | Equipment is busy or unavailable on the controller | Wait for the controller to settle and retry |
+
+Always run with `"debug": true` when filing a bug. Passwords and
+session tokens are **redacted automatically** before logs are emitted.
+
+## Install
+
+```bash
+npm install -g homebridge-omnilogic-pool
+```
+
+Or via Homebridge UI: search for **Hayward OmniLogic Pool**.
+
+## Quick start (config.json)
+
+The minimum viable config:
+
+```json
+{
+  "platforms": [
+    {
+      "platform": "OmniLogicPool",
+      "name": "OmniLogic Pool",
+      "username": "you@example.com",
+      "password": "your-omnilogic-password"
+    }
+  ]
+}
+```
+
+That's it. The plugin discovers your Backyard, bodies of water, and
+equipment automatically and exposes them as HomeKit accessories.
+
+## Configuration reference
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `username` | — | OmniLogic account email (required) |
+| `password` | — | OmniLogic account password (required) |
+| `pollIntervalSeconds` | `30` | Telemetry poll cadence. Min `15`. Values below `30` may trigger Hayward rate limiting. |
+| `temperatureUnits` | `F` | `F` or `C` — affects what HomeKit displays for heater setpoints. |
+| `exposeHeaters` | `true` | Expose heaters as Thermostats. |
+| `exposeLights` | `true` | Expose ColorLogic lights as Lightbulbs. |
+| `exposePumps` | `true` | Expose filter and auxiliary pumps. |
+| `exposeChlorinator` | `true` | Expose the chlorinator as a Switch. |
+| `hideEquipmentIds` | `[]` | OmniLogic system IDs to hide from HomeKit. The IDs are logged at startup. |
+| `debug` | `false` | Verbose SOAP request/response logging (auto-redacted). |
+| `disableLogs` | `false` | Suppress every log line emitted by this plugin. |
+
+## Supported equipment
+
+| OmniLogic equipment | HomeKit service | Capabilities |
+| --- | --- | --- |
+| Heater | Thermostat | Off / Heat, target temperature |
+| Variable-speed filter | Fan | On/off + rotation speed (% of max) |
+| Auxiliary pump | Switch | On/off |
+| Chlorinator | Switch | On/off (status only on some firmwares) |
+| ColorLogic light | Lightbulb | On/off (remembers last show) |
+| Body of water (water temp) | Temperature Sensor | Read-only |
+
+## Authentication
+
+Credentials are exchanged for a session token on first launch and the
+token is cached at:
+
+```
+<homebridge persist path>/omnilogic-token.json
+```
+
+The cache file is written with `0600` permissions and bound to the
+configured username — changing the username in `config.json`
+invalidates the cache automatically. The token is refreshed
+transparently when it expires or is rejected mid-session.
+
+## Security notes
+
+- Your OmniLogic credentials live in plain text in Homebridge's
+  `config.json`. That's a Homebridge constraint, not a plugin one —
+  protect the file the same way you would for any other Homebridge
+  plugin.
+- `"debug": true` is **safe to use**: `Password`, `Token`, `UserID`,
+  and `UserId` fields are masked before any log line is emitted.
+  Verify before sharing if you've configured custom log sinks.
+- All API traffic uses HTTPS to `haywardomnilogic.com`. Certificate
+  validation is enabled by default (axios default).
+
+## Development
+
+```bash
+git clone https://github.com/kzaky/OmniLogic.git
+cd OmniLogic
+npm install
+npm run build      # one-shot compile
+npm run lint
+npm run dev        # tsc --watch + node --watch homebridge -I -D
+```
+
+Source layout:
+
+```
+src/
+  index.ts                   # Homebridge entrypoint
+  platform.ts                # Dynamic platform: discovery, polling, log silencing
+  omnilogic-api.ts           # SOAP/XML client (login, MSP, telemetry, set commands)
+  token-store.ts             # Disk-backed token cache (mode 0600, atomic writes)
+  settings.ts                # Constants
+  types.ts                   # Config + accessory context types
+  accessories/
+    base-accessory.ts          # Per-accessory SET mutex + post-SET refresh hook
+    heater-accessory.ts        # Thermostat
+    light-accessory.ts         # Lightbulb (ColorLogic)
+    switch-accessory.ts        # Generic on/off (pumps, chlorinator)
+    filter-pump-accessory.ts   # Variable-speed Fan
+    temperature-sensor-accessory.ts
+```
+
+## Releasing
+
+The publish workflow (`.github/workflows/publish.yml`) triggers on
+`v*.*.*` tags:
+
+1. Bump `version` in `package.json` and add a `CHANGELOG.md` entry.
+2. Commit to `main` and push.
+3. `git tag v0.2.0 && git push origin v0.2.0`.
+4. The workflow runs lint + build, verifies the tag matches the
+   `package.json` version, then publishes to npm with provenance
+   (`NPM_CONFIG_PROVENANCE=true`).
+
+Required setup:
+
+- A repository secret `NPM_TOKEN` (granular npm automation token with
+  publish rights).
+- A GitHub Environment named `npm-publish` bound to that secret. Add
+  yourself as a required reviewer if you want manual approval on
+  every release.
+
+## API reference (for contributors)
+
+The OmniLogic backend is a non-standard SOAP service at
+`https://www.haywardomnilogic.com/HAAPI/HomeAutomation/HomeAutomationService.asmx`.
+This plugin implements requests directly with `axios` +
+`fast-xml-parser`. Methods used:
+
+- `Login`
+- `GetSiteList`
+- `GetMspConfigFile`
+- `GetTelemetryData`
+- `SetHeaterEnable`
+- `SetUIHeaterCmd`
+- `SetUIEquipmentCmd`
+- `SetUIFilterSpeedCmd`
+- `SetStandAloneLightShow`
+
+The MSP and telemetry responses wrap the meaningful payload as a
+string-encoded XML fragment inside a `<Parameter dataType="XML">`
+element. The client handles both the inline-element and string-XML
+forms.
+
+## Disclaimer
+
+Unofficial. Not produced, endorsed, or supported by Hayward
+Industries, Inc. "Hayward" and "OmniLogic" are trademarks of their
+respective owners. Use at your own risk.
+
+## License
+
+[Apache-2.0](./LICENSE)

package/config.schema.json

@@ -0,0 +1,86 @@
+{
+  "pluginAlias": "OmniLogicPool",
+  "pluginType": "platform",
+  "singular": true,
+  "headerDisplay": "Hayward OmniLogic Pool plugin. Enter the same credentials you use in the OmniLogic mobile app.",
+  "footerDisplay": "For help, file an issue at https://github.com/kzaky/OmniLogic/issues.",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Platform Name",
+        "type": "string",
+        "default": "OmniLogic Pool",
+        "required": true
+      },
+      "username": {
+        "title": "OmniLogic Username (email)",
+        "type": "string",
+        "format": "email",
+        "required": true
+      },
+      "password": {
+        "title": "OmniLogic Password",
+        "type": "string",
+        "format": "password",
+        "required": true,
+        "description": "Stored in plain text in Homebridge config.json. Treat your Homebridge config file accordingly."
+      },
+      "pollIntervalSeconds": {
+        "title": "Telemetry Poll Interval (seconds)",
+        "type": "integer",
+        "default": 30,
+        "minimum": 15,
+        "maximum": 600,
+        "description": "How often to poll OmniLogic for live state. Values below 30s may trigger rate limiting from the Hayward cloud."
+      },
+      "temperatureUnits": {
+        "title": "Temperature Units",
+        "type": "string",
+        "default": "F",
+        "oneOf": [
+          { "title": "Fahrenheit", "enum": ["F"] },
+          { "title": "Celsius", "enum": ["C"] }
+        ]
+      },
+      "exposeChlorinator": {
+        "title": "Expose Chlorinator as Switch",
+        "type": "boolean",
+        "default": true
+      },
+      "exposePumps": {
+        "title": "Expose Pumps",
+        "type": "boolean",
+        "default": true
+      },
+      "exposeLights": {
+        "title": "Expose Lights",
+        "type": "boolean",
+        "default": true
+      },
+      "exposeHeaters": {
+        "title": "Expose Heaters as Thermostats",
+        "type": "boolean",
+        "default": true
+      },
+      "hideEquipmentIds": {
+        "title": "Hide Equipment IDs",
+        "type": "array",
+        "items": { "type": "integer" },
+        "description": "OmniLogic system IDs to suppress from HomeKit. Look at the Homebridge log on startup to see the discovered IDs."
+      },
+      "debug": {
+        "title": "Debug Logging",
+        "type": "boolean",
+        "default": false,
+        "description": "Logs full SOAP request/response XML. Passwords and tokens are redacted automatically."
+      },
+      "disableLogs": {
+        "title": "Disable All Plugin Logs",
+        "type": "boolean",
+        "default": false,
+        "description": "Suppress every log line emitted by this plugin. Use only if you've already validated the setup."
+      }
+    }
+  }
+}

package/dist/accessories/base-accessory.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseAccessory = void 0;
+class BaseAccessory {
+    platform;
+    accessory;
+    ctx;
+    setQueue = Promise.resolve();
+    constructor(platform, accessory) {
+        this.platform = platform;
+        this.accessory = accessory;
+        this.ctx = accessory.context;
+        this.setInformation();
+        this.setup();
+        if (platform.latestTelemetry) {
+            this.onTelemetry(platform.latestTelemetry);
+        }
+    }
+    setInformation() {
+        const info = this.accessory.getService(this.platform.Service.AccessoryInformation) ??
+            this.accessory.addService(this.platform.Service.AccessoryInformation);
+        info
+            .setCharacteristic(this.platform.Characteristic.Manufacturer, 'Hayward')
+            .setCharacteristic(this.platform.Characteristic.Model, `OmniLogic ${this.ctx.kind}`)
+            .setCharacteristic(this.platform.Characteristic.SerialNumber, `${this.ctx.mspSystemId}-${this.ctx.equipmentId}`);
+    }
+    getOrAddService(type) {
+        return (this.accessory.getService(type) ?? this.accessory.addService(type));
+    }
+    telemetryNode(snap) {
+        return snap.byId.get(this.ctx.equipmentId);
+    }
+    bowTelemetry(snap) {
+        return snap.byId.get(this.ctx.bowId);
+    }
+    /**
+     * Serialize SET operations on this accessory. HomeKit can fire concurrent
+     * SETs for related characteristics (e.g. TargetState + TargetTemperature)
+     * which race over OmniLogic's serial protocol; we queue them per accessory
+     * so each completes before the next begins.
+     */
+    runSet(fn) {
+        const next = this.setQueue.then(fn, fn);
+        // Swallow errors from queue chain so a failure doesn't poison later sets.
+        this.setQueue = next.catch(() => undefined);
+        return next;
+    }
+    /**
+     * Kick a telemetry refresh shortly after a successful SET so HomeKit
+     * doesn't show stale state for the full poll interval.
+     */
+    requestPostSetRefresh() {
+        this.platform.scheduleTelemetryRefresh();
+    }
+    /**
+     * Standard wrapper for a HomeKit SET handler: serialize via the
+     * per-accessory mutex, log+rethrow on failure, refresh telemetry on
+     * success.
+     */
+    runApiSet(label, fn) {
+        return this.runSet(async () => {
+            try {
+                await fn();
+                this.requestPostSetRefresh();
+            }
+            catch (err) {
+                this.platform.log.error(`${label} failed:`, err.message);
+                throw err;
+            }
+        });
+    }
+}
+exports.BaseAccessory = BaseAccessory;
+//# sourceMappingURL=base-accessory.js.map

package/dist/accessories/base-accessory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-accessory.js","sourceRoot":"","sources":["../../src/accessories/base-accessory.ts"],"names":[],"mappings":";;;AAKA,MAAsB,aAAa;IAKZ;IACA;IALF,GAAG,CAAmB;IACjC,QAAQ,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEvD,YACqB,QAA2B,EAC3B,SAA8C;QAD9C,aAAQ,GAAR,QAAQ,CAAmB;QAC3B,cAAS,GAAT,SAAS,CAAqC;QAEjE,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC7B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAES,cAAc;QACtB,MAAM,IAAI,GACR,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,oBAAoB,CAAC;YACrE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAExE,IAAI;aACD,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,YAAY,EAAE,SAAS,CAAC;aACvE,iBAAiB,CAChB,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,EAClC,aAAa,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAC7B;aACA,iBAAiB,CAChB,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,YAAY,EACzC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAClD,CAAC;IACN,CAAC;IAES,eAAe,CAAC,IAA0B;QAClD,OAAO,CACL,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CACnE,CAAC;IACJ,CAAC;IAES,aAAa,CAAC,IAAuB;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAES,YAAY,CAAC,IAAuB;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACO,MAAM,CAAI,EAAoB;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACxC,0EAA0E;QAC1E,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACO,qBAAqB;QAC7B,IAAI,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACO,SAAS,CAAC,KAAa,EAAE,EAAuB;QACxD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC;gBACH,MAAM,EAAE,EAAE,CAAC;gBACX,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC/B,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBACzD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CAIF;AAvFD,sCAuFC"}

package/dist/accessories/filter-pump-accessory.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterPumpAccessory = void 0;
+const base_accessory_1 = require("./base-accessory");
+/**
+ * Variable-speed filter pump exposed as a Fan with rotation speed = % of max.
+ * On/Off maps to speed 0 vs. the last non-zero speed (default 100).
+ */
+class FilterPumpAccessory extends base_accessory_1.BaseAccessory {
+    service;
+    isOn = false;
+    speed = 100;
+    lastNonZeroSpeed = 100;
+    setup() {
+        this.service = this.getOrAddService(this.platform.Service.Fan);
+        this.service.setCharacteristic(this.platform.Characteristic.Name, this.ctx.name);
+        this.service
+            .getCharacteristic(this.platform.Characteristic.On)
+            .onGet(() => this.isOn)
+            .onSet(this.handleOnSet.bind(this));
+        this.service
+            .getCharacteristic(this.platform.Characteristic.RotationSpeed)
+            .setProps({ minValue: 0, maxValue: 100, minStep: 1 })
+            .onGet(() => this.speed)
+            .onSet(this.handleSpeedSet.bind(this));
+    }
+    onTelemetry(snap) {
+        const node = this.telemetryNode(snap);
+        if (!node)
+            return;
+        const reported = Number(node['@_filterSpeed']) ||
+            Number(node['@_speed']) ||
+            Number(node['@_pumpSpeed']);
+        if (Number.isFinite(reported)) {
+            this.speed = Math.max(0, Math.min(100, reported));
+            this.isOn = this.speed > 0;
+            if (this.speed > 0)
+                this.lastNonZeroSpeed = this.speed;
+            this.service.updateCharacteristic(this.platform.Characteristic.On, this.isOn);
+            this.service.updateCharacteristic(this.platform.Characteristic.RotationSpeed, this.speed);
+        }
+    }
+    async handleOnSet(value) {
+        const on = !!value;
+        const desired = on ? this.lastNonZeroSpeed || 100 : 0;
+        await this.applySpeed(desired);
+    }
+    async handleSpeedSet(value) {
+        const desired = Number(value);
+        if (desired > 0)
+            this.lastNonZeroSpeed = desired;
+        await this.applySpeed(desired);
+    }
+    async applySpeed(speed) {
+        this.speed = speed;
+        this.isOn = speed > 0;
+        await this.runApiSet('Filter speed set', () => this.platform.api.setFilterSpeed(this.ctx.mspSystemId, this.ctx.bowId, this.ctx.equipmentId, speed));
+    }
+}
+exports.FilterPumpAccessory = FilterPumpAccessory;
+//# sourceMappingURL=filter-pump-accessory.js.map

package/dist/accessories/filter-pump-accessory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-pump-accessory.js","sourceRoot":"","sources":["../../src/accessories/filter-pump-accessory.ts"],"names":[],"mappings":"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"}

package/dist/accessories/heater-accessory.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeaterAccessory = void 0;
+const base_accessory_1 = require("./base-accessory");
+const F_MIN = 50;
+const F_MAX = 104;
+class HeaterAccessory extends base_accessory_1.BaseAccessory {
+    service;
+    currentTempC = 20;
+    targetTempC = 26;
+    enabled = false;
+    setup() {
+        this.service = this.getOrAddService(this.platform.Service.Thermostat);
+        this.service.setCharacteristic(this.platform.Characteristic.Name, this.ctx.name);
+        this.service
+            .getCharacteristic(this.platform.Characteristic.TargetHeatingCoolingState)
+            .setProps({
+            validValues: [
+                this.platform.Characteristic.TargetHeatingCoolingState.OFF,
+                this.platform.Characteristic.TargetHeatingCoolingState.HEAT,
+            ],
+        })
+            .onGet(() => this.enabled
+            ? this.platform.Characteristic.TargetHeatingCoolingState.HEAT
+            : this.platform.Characteristic.TargetHeatingCoolingState.OFF)
+            .onSet(this.handleTargetStateSet.bind(this));
+        this.service
+            .getCharacteristic(this.platform.Characteristic.CurrentHeatingCoolingState)
+            .setProps({
+            validValues: [
+                this.platform.Characteristic.CurrentHeatingCoolingState.OFF,
+                this.platform.Characteristic.CurrentHeatingCoolingState.HEAT,
+            ],
+        });
+        const minC = this.fToC(F_MIN);
+        const maxC = this.fToC(F_MAX);
+        this.service
+            .getCharacteristic(this.platform.Characteristic.TargetTemperature)
+            .setProps({ minValue: minC, maxValue: maxC, minStep: 0.5 })
+            .onGet(() => this.targetTempC)
+            .onSet(this.handleTargetTempSet.bind(this));
+        this.service
+            .getCharacteristic(this.platform.Characteristic.CurrentTemperature)
+            .onGet(() => this.currentTempC);
+        const wantsF = (this.platform.config.temperatureUnits ?? 'F') === 'F';
+        this.service.setCharacteristic(this.platform.Characteristic.TemperatureDisplayUnits, wantsF
+            ? this.platform.Characteristic.TemperatureDisplayUnits.FAHRENHEIT
+            : this.platform.Characteristic.TemperatureDisplayUnits.CELSIUS);
+    }
+    onTelemetry(snap) {
+        const node = this.telemetryNode(snap);
+        const bow = this.bowTelemetry(snap);
+        if (!node && !bow)
+            return;
+        const reportedF = Number(node?.['@_temp']) ||
+            Number(bow?.['@_waterTemp']) ||
+            Number(bow?.['@_temp']);
+        const setpointF = Number(node?.['@_Current-Set-Point']) ||
+            Number(node?.['@_currentSetPoint']) ||
+            Number(node?.['@_settingsTemp']);
+        const enabled = Number(node?.['@_enable']) === 1 ||
+            String(node?.['@_enable']).toLowerCase() === 'true' ||
+            Number(node?.['@_heaterState']) === 1;
+        if (Number.isFinite(reportedF) && reportedF > 0) {
+            this.currentTempC = this.fToC(reportedF);
+            this.service.updateCharacteristic(this.platform.Characteristic.CurrentTemperature, this.currentTempC);
+        }
+        if (Number.isFinite(setpointF) && setpointF > 0) {
+            this.targetTempC = this.fToC(setpointF);
+            this.service.updateCharacteristic(this.platform.Characteristic.TargetTemperature, this.targetTempC);
+        }
+        this.enabled = enabled;
+        this.service.updateCharacteristic(this.platform.Characteristic.CurrentHeatingCoolingState, enabled
+            ? this.platform.Characteristic.CurrentHeatingCoolingState.HEAT
+            : this.platform.Characteristic.CurrentHeatingCoolingState.OFF);
+        this.service.updateCharacteristic(this.platform.Characteristic.TargetHeatingCoolingState, enabled
+            ? this.platform.Characteristic.TargetHeatingCoolingState.HEAT
+            : this.platform.Characteristic.TargetHeatingCoolingState.OFF);
+    }
+    async handleTargetStateSet(value) {
+        const want = value === this.platform.Characteristic.TargetHeatingCoolingState.HEAT;
+        this.enabled = want;
+        await this.runApiSet('Heater enable', () => this.platform.api.setHeaterEnable(this.ctx.mspSystemId, this.ctx.bowId, this.ctx.equipmentId, want));
+    }
+    async handleTargetTempSet(value) {
+        const tempC = Number(value);
+        this.targetTempC = tempC;
+        const tempF = this.cToF(tempC);
+        await this.runApiSet('Heater setpoint', () => this.platform.api.setHeaterSetpoint(this.ctx.mspSystemId, this.ctx.bowId, this.ctx.equipmentId, tempF));
+    }
+    fToC(f) {
+        return Math.round((((f - 32) * 5) / 9) * 2) / 2;
+    }
+    cToF(c) {
+        return Math.round((c * 9) / 5 + 32);
+    }
+}
+exports.HeaterAccessory = HeaterAccessory;
+//# sourceMappingURL=heater-accessory.js.map

package/dist/accessories/heater-accessory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heater-accessory.js","sourceRoot":"","sources":["../../src/accessories/heater-accessory.ts"],"names":[],"mappings":"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"}

package/dist/accessories/light-accessory.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LightAccessory = void 0;
+const base_accessory_1 = require("./base-accessory");
+/**
+ * ColorLogic light. Modeled as a Lightbulb with on/off. "Off" sends show 0,
+ * "on" restores the last-known show (default Voodoo Lounge / 1).
+ */
+class LightAccessory extends base_accessory_1.BaseAccessory {
+    service;
+    isOn = false;
+    lastShow = 1;
+    setup() {
+        this.service = this.getOrAddService(this.platform.Service.Lightbulb);
+        this.service.setCharacteristic(this.platform.Characteristic.Name, this.ctx.name);
+        this.service
+            .getCharacteristic(this.platform.Characteristic.On)
+            .onGet(() => this.isOn)
+            .onSet(this.handleOnSet.bind(this));
+    }
+    onTelemetry(snap) {
+        const node = this.telemetryNode(snap);
+        if (!node)
+            return;
+        const state = Number(node['@_lightState']) ||
+            Number(node['@_state']) ||
+            Number(node['@_speed']);
+        const show = Number(node['@_currentShow']);
+        if (Number.isFinite(show) && show > 0)
+            this.lastShow = show;
+        const on = state > 0 || (Number.isFinite(show) && show > 0);
+        this.isOn = on;
+        this.service.updateCharacteristic(this.platform.Characteristic.On, on);
+    }
+    async handleOnSet(value) {
+        const on = !!value;
+        this.isOn = on;
+        await this.runApiSet('Light set', () => this.platform.api.setLightShow(this.ctx.mspSystemId, this.ctx.bowId, this.ctx.equipmentId, on ? this.lastShow : 0));
+    }
+}
+exports.LightAccessory = LightAccessory;
+//# sourceMappingURL=light-accessory.js.map