homebridge-read-your-meter-pro 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aran Shavit
+
+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,178 @@
+# homebridge-read-your-meter-pro
+
+Exposes water consumption from the Israeli [Read Your Meter Pro](https://rym-pro.com)
+portal (ARAD meters) in HomeKit.
+
+Unofficial, and not affiliated with Arad Group or any water corporation.
+
+## Read this before installing
+
+**HomeKit has no water-consumption service.** There is no accessory type in the
+HomeKit Accessory Protocol for volume or metering, so there is no honest way to
+show "0.734 m³" in the Home app. This plugin works around that:
+
+| What you get | How | Where it shows |
+| --- | --- | --- |
+| Today's consumption | Light sensor `Water Today` | Home app, as `734 lux` |
+| This month's consumption | Light sensor `Water This Month` | Home app, as `14200 lux` |
+| Month-end forecast | Light sensor `Water Forecast` | Home app |
+| Cumulative meter reading | Light sensor `Water Meter Total` | Home app, optional, always m³ |
+| Daily threshold exceeded | Leak sensor `Water Daily Alert` | Home app, notifications, automations |
+| Monthly threshold exceeded | Leak sensor `Water Monthly Alert` | Home app, notifications, automations |
+
+The word "lux" is wrong and there is nothing to be done about it. The number is
+correct. Service names carry no unit, because HomeKit rejects names that end in
+punctuation or contain symbols like `³`.
+
+### Why a light sensor?
+
+This is a deliberate compromise, not an oversight. HAP defines `Valve`,
+`Faucet`, `IrrigationSystem` and `LeakSensor`, but nothing that carries a volume
+or a meter reading, and Apple provides no mechanism for a custom unit that the
+Home app will render. The alternatives were:
+
+- **Eve custom characteristics.** Spec-correct, but the values appear only in
+  the Eve app and never in Apple Home, and the `E863F131` encoding is
+  reverse-engineered rather than documented.
+- **Show nothing numeric at all.** Leak sensors only. Honest, but users
+  reasonably want to glance at a number.
+- **A light sensor carrying the value.** Works in every HomeKit client, no
+  reverse engineering, at the cost of a wrong unit label.
+
+The third option loses one label and keeps everything else, so that is what this
+plugin does. The leak sensors remain the functional core — they are a real
+sensor type, so notifications and automations behave correctly.
+
+The **leak sensors are the point**. They are a real HomeKit sensor type, so you
+get push notifications and automation triggers for free — "notify me if today's
+usage passes 500 L" is a decent leak detector for a house. The light sensors are
+there so you can glance at a number; if you want graphs, put the data in
+Prometheus/InfluxDB instead, not HomeKit.
+
+## Requirements
+
+- An account at [rym-pro.com](https://rym-pro.com). Registration fails if your
+  meter is not an ARAD unit or your water corporation has not migrated to the
+  Pro portal — verify you can log in on the web before installing.
+- Homebridge v1.8+ or v2.x, Node.js 22 or 24.
+- No runtime dependencies, so installation is a single request — which matters
+  on a Raspberry Pi, where npm's per-dependency fetching is slow and failure-prone.
+
+## Installation
+
+```bash
+npm install -g homebridge-read-your-meter-pro
+```
+
+Or search for "Read Your Meter Pro" in the Homebridge UI plugin browser.
+
+## Configuration
+
+Use the Homebridge UI settings form, or add to `config.json`:
+
+```json
+{
+  "platforms": [
+    {
+      "platform": "ReadYourMeterPro",
+      "name": "Read Your Meter Pro",
+      "email": "you@example.com",
+      "password": "your-portal-password",
+      "unit": "liters",
+      "pollInterval": 60,
+      "dailyThreshold": 500,
+      "monthlyThreshold": 20000,
+      "exposeForecast": true,
+      "exposeTotal": false
+    }
+  ]
+}
+```
+
+| Option | Default | Notes |
+| --- | --- | --- |
+| `email` | — | Required. |
+| `password` | — | Required. |
+| `unit` | `liters` | `liters` or `cubic_meters`. Applies to daily/monthly/forecast. |
+| `pollInterval` | `60` | Minutes. Floored at 15. |
+| `dailyThreshold` | `0` | In `unit`. `0` removes the sensor. |
+| `monthlyThreshold` | `0` | In `unit`. `0` removes the sensor. |
+| `exposeForecast` | `true` | Month-end estimate. |
+| `exposeTotal` | `false` | Cumulative reading. Always m³. |
+
+### Why litres by default
+
+HomeKit clamps light level to `0.0001 .. 100000` lux. Daily consumption in m³
+lands around `0.7`, which the Home app rounds to something useless. In litres it
+reads as `734`. The cumulative total is the exception — a lifetime reading in
+litres blows past the 100000 ceiling, so it is always reported in m³.
+
+### Poll politely
+
+The meter uploads at most hourly, often daily. Polling every minute gains you
+nothing and hammers someone else's infrastructure. The plugin refuses intervals
+below 15 minutes.
+
+## Behaviour worth knowing
+
+- **Auth**: the plugin logs in once, caches the bearer token, and re-authenticates
+  silently on a 401. If the portal rejects your credentials outright it stops
+  polling and logs an error rather than retrying on a timer and risking a lockout.
+- **Credentials**: your email and password live in `config.json`, like every
+  other Homebridge plugin. They are never written anywhere else and never logged.
+- **State**: a generated `deviceId` and the cached session token live in
+  `<homebridge storage>/.read-your-meter-pro.json` (mode 0600), following the
+  same convention as `homebridge-ring`'s `.ring.json`. The `deviceId` must stay
+  stable across restarts, because the portal registers a device per id. Writes
+  are atomic (temp file plus rename) and serialised, so a crash mid-write cannot
+  leave a truncated file that forces a new device registration on next boot.
+  Deleting the file is safe: the plugin mints a new id and logs in again.
+- **Failures**: a failed poll sets `StatusFault` and clears `StatusActive` on
+  every service, so an outage is visible rather than silently stale. It clears on
+  the next successful poll. If the *first* poll after a restart fails, cached
+  accessories are still wired up so they report the fault instead of sitting at
+  default values, and the plugin retries every minute until it has something to
+  show before settling into the configured interval.
+- **Reconfiguration**: setting a threshold to `0`, or turning off the forecast or
+  total, removes those services on the next restart instead of leaving ghosts.
+
+## Development
+
+```bash
+npm install
+npm run lint
+npm run build
+npm test        # lint + build + smoke tests against a mocked portal
+```
+
+The smoke tests need no credentials and touch no network: they stub `fetch` with
+a fake portal and drive the plugin through Homebridge's real `PlatformAccessory`
+and HAP-NodeJS `Service`/`Characteristic` classes. CI runs them on Node 22 and 24.
+
+## Verifying the API against your account
+
+If a field looks wrong, or the portal changes shape, dump the raw responses:
+
+```bash
+RYM_EMAIL=you@example.com RYM_PW='your-password' npm run probe
+```
+
+For verbose runtime logs, enable Homebridge's own debug mode (`homebridge -D`,
+or the debug toggle on this plugin's child bridge in the Homebridge UI). The
+plugin deliberately has no `debug` option of its own.
+
+This prints a **redacted** summary of every endpoint the plugin uses — safe to
+paste into an issue — and writes the full unredacted response to
+`probe-output.json` (mode 0600, gitignored) for your own inspection. Delete that
+file when you are done.
+
+## Credits
+
+Endpoint knowledge derived from [pyrympro](https://github.com/OnFreund/pyrympro)
+(MIT, On Freund). Originally inspired by
+[read_your_meter](https://github.com/eyalcha/read_your_meter) (Apache-2.0,
+eyalcha). See [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md).
+
+## License
+
+MIT

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,51 @@
+# Third-party notices
+
+This plugin contains no third-party code. It does, however, owe its
+understanding of the Read Your Meter Pro API to prior work, acknowledged here.
+
+## pyrympro
+
+The endpoint layout used in `src/rympro.ts` — the base URL, the
+`/consumer/login`, `/consumer/me`, `/consumption/last-read`,
+`/consumption/forecast/{meter}`, `/consumption/{daily,monthly}/{meter}/{from}/{to}`
+paths, the `x-access-token` header, and the meaning of login error code 5060 —
+was derived from **pyrympro** by On Freund, used by the Home Assistant
+`rympro` integration.
+
+- Source: https://github.com/OnFreund/pyrympro
+- License: MIT
+
+```
+MIT License
+
+Copyright (c) 2022 On Freund
+
+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.
+```
+
+## read_your_meter
+
+The original inspiration for this plugin was **read_your_meter** by eyalcha
+(Apache-2.0), a Home Assistant custom component that scraped the older
+Selenium-driven portal. No code from that project is used here — it targets a
+different portal by a different mechanism — but credit is due for showing the
+problem was worth solving.
+
+- Source: https://github.com/eyalcha/read_your_meter
+- License: Apache-2.0

package/config.schema.json

@@ -0,0 +1,113 @@
+{
+  "pluginAlias": "ReadYourMeterPro",
+  "pluginType": "platform",
+  "singular": true,
+  "headerDisplay": "Exposes your Read Your Meter Pro water meter in HomeKit. HomeKit has no water-consumption service, so readings are surfaced as **light sensors** (the number is your consumption, the unit says \"lux\" \u2014 ignore it) and thresholds as **leak sensors** you can use for automations and notifications.",
+  "footerDisplay": "For verbose logs, enable Homebridge debug mode (or the debug toggle on this plugin's child bridge). Unofficial; not affiliated with Arad Group or any water corporation.",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "default": "Read Your Meter Pro",
+        "required": true
+      },
+      "email": {
+        "title": "Email",
+        "type": "string",
+        "format": "email",
+        "required": true,
+        "description": "The email address you use to sign in at rym-pro.com."
+      },
+      "password": {
+        "title": "Password",
+        "type": "string",
+        "required": true,
+        "x-schema-form": {
+          "type": "password"
+        }
+      },
+      "pollInterval": {
+        "title": "Poll interval (minutes)",
+        "type": "integer",
+        "default": 60,
+        "minimum": 15,
+        "maximum": 1440,
+        "description": "The meter itself only reports hourly at best, so there is nothing to gain below 60."
+      },
+      "unit": {
+        "title": "Unit",
+        "type": "string",
+        "default": "liters",
+        "oneOf": [
+          {
+            "title": "Litres",
+            "enum": [
+              "liters"
+            ]
+          },
+          {
+            "title": "Cubic metres (m\u00b3)",
+            "enum": [
+              "cubic_meters"
+            ]
+          }
+        ],
+        "description": "Litres read better in the Home app: 734 instead of 0.734."
+      },
+      "dailyThreshold": {
+        "title": "Daily alert threshold",
+        "type": "number",
+        "default": 0,
+        "minimum": 0,
+        "description": "Trips the daily leak sensor when today's consumption reaches this value, in the unit selected above. 0 disables the sensor."
+      },
+      "monthlyThreshold": {
+        "title": "Monthly alert threshold",
+        "type": "number",
+        "default": 0,
+        "minimum": 0,
+        "description": "Trips the monthly leak sensor when this month's consumption reaches this value. 0 disables the sensor."
+      },
+      "exposeForecast": {
+        "title": "Expose month-end forecast",
+        "type": "boolean",
+        "default": true
+      },
+      "exposeTotal": {
+        "title": "Expose cumulative meter reading",
+        "type": "boolean",
+        "default": false,
+        "description": "Always reported in m\u00b3, since a lifetime total in litres exceeds HomeKit's 100000 ceiling."
+      }
+    }
+  },
+  "layout": [
+    "email",
+    "password",
+    {
+      "type": "fieldset",
+      "title": "Alerts",
+      "expandable": true,
+      "expanded": true,
+      "items": [
+        "dailyThreshold",
+        "monthlyThreshold"
+      ]
+    },
+    {
+      "type": "fieldset",
+      "title": "Advanced",
+      "expandable": true,
+      "expanded": false,
+      "items": [
+        "name",
+        "unit",
+        "pollInterval",
+        "exposeForecast",
+        "exposeTotal"
+      ]
+    }
+  ]
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { API } from 'homebridge';
+declare const _default: (api: API) => void;
+export default _default;

package/dist/index.js

@@ -0,0 +1,6 @@
+import { RymProPlatform } from './platform.js';
+import { PLATFORM_NAME, PLUGIN_NAME } from './settings.js';
+export default (api) => {
+    api.registerPlatform(PLUGIN_NAME, PLATFORM_NAME, RymProPlatform);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3D,eAAe,CAAC,GAAQ,EAAQ,EAAE;IAChC,GAAG,CAAC,gBAAgB,CAAC,WAAW,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;AACnE,CAAC,CAAC"}

package/dist/meterAccessory.d.ts

@@ -0,0 +1,26 @@
+import type { PlatformAccessory } from 'homebridge';
+import type { RymProPlatform } from './platform.js';
+import type { MeterSnapshot } from './rympro.js';
+import { type ResolvedConfig } from './settings.js';
+export declare class MeterAccessory {
+    private readonly platform;
+    readonly accessory: PlatformAccessory;
+    private readonly config;
+    private readonly services;
+    private readonly unit;
+    private readonly information;
+    constructor(platform: RymProPlatform, accessory: PlatformAccessory, config: ResolvedConfig);
+    /** Which services this accessory should expose, given the current config. */
+    private desiredServices;
+    private buildServices;
+    update(snapshot: MeterSnapshot): void;
+    /** Flags every service as faulted so the failure is visible in the Home app. */
+    setFaulted(): void;
+    private setLux;
+    private setLeak;
+}
+/**
+ * HomeKit rejects values outside 0.0001..100000 lux, and a real zero reading is
+ * common right after midnight, so genuine zeroes have to floor at 0.0001.
+ */
+export declare function clampLux(value: number): number;

package/dist/meterAccessory.js

@@ -0,0 +1,162 @@
+import { LUX_MAX, LUX_MIN } from './settings.js';
+export class MeterAccessory {
+    platform;
+    accessory;
+    config;
+    services = new Map();
+    unit;
+    information;
+    constructor(platform, accessory, config) {
+        this.platform = platform;
+        this.accessory = accessory;
+        this.config = config;
+        this.unit = config.unit;
+        const { Service, Characteristic } = platform;
+        const meterCount = accessory.context.meterCount;
+        this.information = (accessory.getService(Service.AccessoryInformation) ??
+            accessory.addService(Service.AccessoryInformation))
+            .setCharacteristic(Characteristic.Manufacturer, 'Arad / Read Your Meter Pro')
+            .setCharacteristic(Characteristic.Model, 'Water Meter')
+            .setCharacteristic(Characteristic.SerialNumber, String(meterCount));
+        this.buildServices();
+    }
+    /** Which services this accessory should expose, given the current config. */
+    desiredServices() {
+        // HomeKit requires names to start and end with a letter or digit, and
+        // rejects symbols like the superscript in "m³" — so no units in the name.
+        // The unit is a config choice and is documented in the plugin settings.
+        const specs = [
+            { subtype: 'daily', name: 'Water Today', kind: 'light' },
+            { subtype: 'monthly', name: 'Water This Month', kind: 'light' },
+        ];
+        if (this.config.exposeForecast) {
+            specs.push({ subtype: 'forecast', name: 'Water Forecast', kind: 'light' });
+        }
+        if (this.config.exposeTotal) {
+            specs.push({ subtype: 'total', name: 'Water Meter Total', kind: 'light' });
+        }
+        if (this.config.dailyThreshold > 0) {
+            specs.push({ subtype: 'daily-alert', name: 'Water Daily Alert', kind: 'leak' });
+        }
+        if (this.config.monthlyThreshold > 0) {
+            specs.push({ subtype: 'monthly-alert', name: 'Water Monthly Alert', kind: 'leak' });
+        }
+        return specs;
+    }
+    buildServices() {
+        const { Service, Characteristic } = this.platform;
+        const specs = this.desiredServices();
+        const wanted = new Set(specs.map((s) => s.subtype));
+        // Remove services left over from a previous config (e.g. a threshold that
+        // was set to 0, or the forecast sensor being switched off).
+        for (const service of [...this.accessory.services]) {
+            const subtype = service.subtype;
+            if (service.UUID !== Service.AccessoryInformation.UUID &&
+                subtype !== undefined &&
+                !wanted.has(subtype)) {
+                this.platform.log.info(`Removing no-longer-configured service "${service.displayName}" from ${this.accessory.displayName}`);
+                this.accessory.removeService(service);
+            }
+        }
+        for (const spec of specs) {
+            const type = spec.kind === 'light' ? Service.LightSensor : Service.LeakSensor;
+            const service = this.accessory.getServiceById(type, spec.subtype) ??
+                this.accessory.addService(type, spec.name, spec.subtype);
+            service.setCharacteristic(Characteristic.Name, spec.name);
+            if (Characteristic.ConfiguredName) {
+                // Lets the Home app show a sane per-service label instead of "Sensor".
+                if (!service.testCharacteristic(Characteristic.ConfiguredName)) {
+                    service.addOptionalCharacteristic(Characteristic.ConfiguredName);
+                }
+                service.updateCharacteristic(Characteristic.ConfiguredName, spec.name);
+            }
+            service.setCharacteristic(Characteristic.StatusActive, true);
+            service.setCharacteristic(Characteristic.StatusFault, Characteristic.StatusFault.NO_FAULT);
+            this.services.set(spec.subtype, service);
+        }
+    }
+    update(snapshot) {
+        const { Characteristic } = this.platform;
+        const factor = this.unit === 'liters' ? 1000 : 1;
+        const scale = (v) => (v === null ? null : v * factor);
+        const daily = scale(snapshot.daily);
+        const monthly = scale(snapshot.monthly);
+        // A null reading means "not published yet", not "zero". Leaving the last
+        // known value in place beats flashing a zero every morning; the very first
+        // poll has nothing to keep, so it floors instead.
+        this.setLux('daily', daily);
+        this.setLux('monthly', monthly);
+        this.setLux('forecast', scale(snapshot.forecast));
+        // Total is always m³: a cumulative reading in litres blows past the
+        // 100000 lux ceiling within a couple of years of normal household use.
+        this.setLux('total', snapshot.total);
+        // With no reading there is nothing to compare, so the alert stays clear
+        // rather than tripping or clearing on invented data.
+        if (daily !== null) {
+            if (snapshot.serial) {
+                // The physical serial only arrives with the first poll, so it cannot be
+                // set in the constructor.
+                this.information.updateCharacteristic(this.platform.Characteristic.SerialNumber, snapshot.serial);
+            }
+            this.setLeak('daily-alert', daily >= this.config.dailyThreshold);
+        }
+        if (monthly !== null) {
+            this.setLeak('monthly-alert', monthly >= this.config.monthlyThreshold);
+        }
+        for (const service of this.services.values()) {
+            service.updateCharacteristic(Characteristic.StatusActive, true);
+            service.updateCharacteristic(Characteristic.StatusFault, Characteristic.StatusFault.NO_FAULT);
+        }
+        const unitLabel = this.unit === 'liters' ? 'L' : 'm³';
+        const show = (v) => (v === null ? 'no reading yet' : `${round(v)}${unitLabel}`);
+        this.platform.log.debug(`Meter ${snapshot.meterCount}: today=${show(daily)} month=${show(monthly)} ` +
+            `forecast=${show(scale(snapshot.forecast))} total=${round(snapshot.total)}m³`);
+    }
+    /** Flags every service as faulted so the failure is visible in the Home app. */
+    setFaulted() {
+        const { Characteristic } = this.platform;
+        for (const service of this.services.values()) {
+            service.updateCharacteristic(Characteristic.StatusActive, false);
+            service.updateCharacteristic(Characteristic.StatusFault, Characteristic.StatusFault.GENERAL_FAULT);
+        }
+    }
+    setLux(subtype, value) {
+        const service = this.services.get(subtype);
+        if (!service) {
+            return;
+        }
+        if (value === null) {
+            // Keep whatever was last published rather than reporting a false zero.
+            return;
+        }
+        if (value > LUX_MAX) {
+            this.platform.log.warn(`${service.displayName}: ${round(value)} exceeds HomeKit's 100000 lux ceiling and was clamped. ` +
+                'Switch "unit" to cubic_meters if this keeps happening.');
+        }
+        service.updateCharacteristic(this.platform.Characteristic.CurrentAmbientLightLevel, clampLux(value));
+    }
+    setLeak(subtype, tripped) {
+        const service = this.services.get(subtype);
+        if (!service) {
+            return;
+        }
+        const { Characteristic } = this.platform;
+        service.updateCharacteristic(Characteristic.LeakDetected, tripped
+            ? Characteristic.LeakDetected.LEAK_DETECTED
+            : Characteristic.LeakDetected.LEAK_NOT_DETECTED);
+    }
+}
+/**
+ * HomeKit rejects values outside 0.0001..100000 lux, and a real zero reading is
+ * common right after midnight, so genuine zeroes have to floor at 0.0001.
+ */
+export function clampLux(value) {
+    if (!Number.isFinite(value)) {
+        return LUX_MIN;
+    }
+    return Math.min(LUX_MAX, Math.max(LUX_MIN, value));
+}
+function round(value) {
+    return Math.round(value * 1000) / 1000;
+}
+//# sourceMappingURL=meterAccessory.js.map

package/dist/meterAccessory.js.map

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

package/dist/platform.d.ts

@@ -0,0 +1,46 @@
+import type { API, Characteristic, DynamicPlatformPlugin, Logging, PlatformAccessory, Service } from 'homebridge';
+import { type ResolvedConfig, type RymProPlatformConfig } from './settings.js';
+export declare class RymProPlatform implements DynamicPlatformPlugin {
+    readonly log: Logging;
+    readonly api: API;
+    readonly Service: typeof Service;
+    readonly Characteristic: typeof Characteristic;
+    /** Accessories restored from Homebridge's cache, keyed by UUID. */
+    private readonly cachedAccessories;
+    private readonly meters;
+    readonly settings: ResolvedConfig | null;
+    private client;
+    private timer;
+    private stopped;
+    private readonly statePath;
+    /** In-memory source of truth; disk is only read once, at startup. */
+    private state;
+    /** Serialises writes so a fire-and-forget save can't interleave with another. */
+    private writeQueue;
+    private hadSuccessfulPoll;
+    constructor(log: Logging, config: RymProPlatformConfig, api: API);
+    /** Called by Homebridge for each accessory restored from disk cache. */
+    configureAccessory(accessory: PlatformAccessory): void;
+    private start;
+    private poll;
+    private scheduleNext;
+    /**
+     * Wires up handlers for accessories restored from cache that have not been
+     * matched to a live meter yet. Without this, a failed first poll after a
+     * restart leaves cached accessories visible in the Home app with default
+     * values and no fault indication.
+     */
+    private adoptCachedAccessories;
+    private syncAccessories;
+    private markFaulted;
+    private loadState;
+    /**
+     * Merges a patch into the in-memory state and queues an atomic write.
+     * Writes are chained rather than fired in parallel: `writeFile` truncates
+     * before it writes, so two concurrent saves can leave a half-written file
+     * that fails to parse on the next start.
+     */
+    private persist;
+    /** Test hook: resolves once every queued write has landed. */
+    flushState(): Promise<void>;
+}