homebridge-rainforest-eagle3 1.0.0 → 1.2.0

package/dist/matterEnergy.d.ts

@@ -0,0 +1,176 @@
+/**
+ * matterEnergy.ts
+ *
+ * Publishes the EAGLE grid meter to Matter controllers as a single
+ * bidirectional ElectricalSensor reporting live power and cumulative /
+ * periodic energy, so it feeds the Apple Home Energy view (iOS 27+).
+ *
+ * Background
+ * ----------
+ * Apple Home's Energy view is driven by Matter electrical-measurement
+ * clusters, not by classic HomeKit/HAP characteristics. HAP has no native
+ * power/energy characteristic, so the Eve custom characteristics this plugin
+ * also exposes (see eveCharacteristics.ts) are only ever read by Eve-class
+ * apps and never populate the native Energy tile.
+ *
+ * Device type: ElectricalSensor, not OnOffOutlet
+ * -----------------------------------------------
+ * A pure metering device type like ElectricalSensor has no actionable
+ * primary cluster, so its tile in the Home app shows "Not Supported" as its
+ * headline status. That's an accepted tradeoff here: the meter is not
+ * actually controllable, and an on/off state would only ever be a workaround
+ * for the tile headline — the wattage still rolls into the Home aggregate
+ * and (via PeriodicEnergy, below) into this accessory's own Energy-view
+ * attribution either way.
+ *
+ *   powerW    -> electricalPowerMeasurement.activePower                        (mW, signed)
+ *   energyKWh -> electricalEnergyMeasurement.cumulativeEnergyImported.energy   (mWh)
+ *             and .cumulativeEnergyExported.energy, since the grid meter is
+ *             bidirectional (see EnergyDirection below).
+ *
+ * Matter expresses power in milliwatts and energy in milliwatt-hours, hence
+ * the x1000 / x1,000,000 conversions. cumulativeEnergyImported/Exported are
+ * themselves structs (EnergyMeasurementStruct — { energy, startTimestamp?,
+ * endTimestamp?, ... }), not plain numbers: Homebridge's updateAccessoryState()
+ * accepts and normalizes a flat number for convenience, but the *initial*
+ * state passed at registration goes straight to matter.js's struct-typed
+ * attribute and must already be an object, or registration fails with
+ * "Cannot manage number because it is not a struct".
+ *
+ * Homebridge derives the mandatory cluster attributes (powerMode, accuracy,
+ * numberOfMeasurementTypes) and the feature-gated ElectricalEnergyMeasurement
+ * features from the declared state — declaring `cumulativeEnergyImported`
+ * selects the ImportedEnergy + CumulativeEnergy features, `cumulativeEnergyExported`
+ * selects ExportedEnergy + CumulativeEnergy, and both together (for a
+ * bidirectional meter) select both pairs at once. No voltage/current data is
+ * available from the EAGLE's local API, so only activePower is declared;
+ * voltage/activeCurrent are optional per the Matter spec and are simply
+ * omitted.
+ *
+ * Imported vs. exported energy is always two separate attributes
+ * ------------------------------------------------------------
+ * `activePower` is a signed attribute (positive = importing, negative =
+ * exporting), so this single bidirectional meter can report live direction
+ * with one accessory. Cumulative/periodic *energy* has no equivalent signed
+ * "net" attribute, though: Imported and Exported are distinct lifetime
+ * running totals per the Matter spec (you don't want a day's export and
+ * import cancelling each other out), so the meter declares both
+ * `cumulativeEnergyImported` and `cumulativeEnergyExported` (and their
+ * periodic counterparts) together on the same cluster. This is how the grid
+ * meter is published as a single Matter accessory even though it remains two
+ * separate accessories in Eve/HomeKit (Grid Meter - Import / Grid Meter -
+ * Export) when `showExportMeter` is enabled, since that split is purely
+ * about Eve's inability to represent a negative watt value, not a Matter
+ * limitation.
+ *
+ * Cumulative vs. periodic energy
+ * ------------------------------
+ * Alongside the cumulative (lifetime) total, this module also declares the
+ * PeriodicEnergy feature (`periodicEnergyImported`/`periodicEnergyExported`)
+ * — a per-interval delta with its own start/end timestamps. Per prior art in
+ * homebridge-shelly-matter (github.com/keremerkan/homebridge-shelly-matter,
+ * shellyAccessory.ts), this is what drives Apple Home's per-device energy
+ * attribution in the Energy view, not the cumulative total alone. Matter
+ * features compose once at registration, so PeriodicEnergy must already be
+ * present in the *initial* cluster state passed to registerPlatformAccessories()
+ * — declaring it for the first time in a later updateAccessoryState() call
+ * would not retroactively add the feature. register() therefore seeds a
+ * zero-energy periodic fragment (no timestamps yet).
+ *
+ * Event rate
+ * ----------
+ * Homebridge routes every energy field passed to updateAccessoryState() through
+ * matter.js setMeasurement(), which records a CumulativeEnergyMeasured or
+ * PeriodicEnergyMeasured event for each one. Sending both on every poll
+ * (default 15s) produced events that almost always repeated the previous
+ * total or reported 0 energy, so update() includes each field only when it
+ * carries news:
+ *
+ * - Cumulative: when the total (in mWh) has changed since the last one sent,
+ *   or CUMULATIVE_HEARTBEAT_S has passed, so controllers still get a periodic
+ *   heartbeat while the meter is idle.
+ * - Periodic: energy is accumulated across polls (per-poll deltas, so a meter
+ *   counter that steps backwards doesn't produce a negative period) and
+ *   emitted once per PERIODIC_INTERVAL_S, with start/end timestamps covering
+ *   the whole period. If the previous period was idle (zero energy) and energy
+ *   starts flowing, the period is emitted immediately and a new one starts, so
+ *   a new session starts reporting promptly instead of up to 15 minutes later.
+ *
+ * The periodic baseline is taken from the first real poll, not from the
+ * placeholder readings register() is called with. The first update() after
+ * registration always sends both fields, as before.
+ *
+ * Requirements
+ * ------------
+ * - Homebridge 2.4.0+
+ * - Matter enabled on this plugin's child bridge (Homebridge UI ->
+ *   plugin settings -> Bridge Settings -> enable Matter)
+ * - iOS/iPadOS 27+ on the device used to view the Apple Home Energy view
+ *
+ * Everything here is feature-detected and guarded: on a Homebridge build
+ * without the Matter API, or with Matter disabled, isSupported() returns
+ * false and the plugin runs HAP/Eve-only exactly as before.
+ */
+import type { API, Logger } from 'homebridge';
+export type EnergyDirection = 'imported' | 'exported' | 'bidirectional';
+export interface EnergyReadings {
+    /** Signed for a 'bidirectional' meter (positive = importing, negative = exporting). */
+    powerW: number;
+    /** Required when direction is 'imported' or 'bidirectional'. */
+    importedEnergyKWh?: number;
+    /** Required when direction is 'exported' or 'bidirectional'. */
+    exportedEnergyKWh?: number;
+}
+export declare class MatterEnergyBridge {
+    private readonly log;
+    private readonly direction;
+    private readonly nowMs;
+    /** Re-send an unchanged cumulative total at least this often. */
+    static readonly CUMULATIVE_HEARTBEAT_S: number;
+    /** Length of one PeriodicEnergyMeasured period. */
+    static readonly PERIODIC_INTERVAL_S: number;
+    private readonly api;
+    private readonly kinds;
+    private uuid;
+    private registered;
+    private warnedUpdate;
+    private sentFirstUpdate;
+    private lastCumulative;
+    private lastReadingKWh;
+    private periodStartS;
+    private periodKWh;
+    private lastPeriodic;
+    private idle;
+    constructor(api: API, log: Logger, direction: EnergyDirection, nowMs?: () => number);
+    /**
+     * Whether this Homebridge build exposes everything needed to publish this
+     * meter. Logs at debug level so unsupported builds stay quiet.
+     */
+    isSupported(): boolean;
+    private nowS;
+    private static readingsByKind;
+    /** Initial cluster state for register(): every energy field, periodic seeded at zero. */
+    private buildInitialClusters;
+    private energyFields;
+    /**
+     * Decide which energy fields this poll should send, updating the cumulative
+     * and periodic bookkeeping. Returns an empty object when nothing is due.
+     */
+    private buildEnergyUpdate;
+    /**
+     * Register this meter as a Matter electrical sensor.
+     *
+     * @param seedKey - unique per-meter key used to derive this accessory's
+     * Matter UUID, distinct from the HAP accessory's UUID
+     * @param displayName
+     * @param serialNumber
+     * @param readings - initial readings to seed the clusters with
+     */
+    register(seedKey: string, displayName: string, serialNumber: string, readings: EnergyReadings): Promise<boolean>;
+    /**
+     * Push fresh readings to the registered Matter accessory. No-op until
+     * registration has succeeded.
+     */
+    update(readings: EnergyReadings): Promise<void>;
+}
+//# sourceMappingURL=matterEnergy.d.ts.map

package/dist/matterEnergy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matterEnergy.d.ts","sourceRoot":"","sources":["../src/matterEnergy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgHG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAkB9C,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,GAAG,eAAe,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAyDD,qBAAa,kBAAkB;IA6B3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IA9BxB,iEAAiE;IACjE,MAAM,CAAC,QAAQ,CAAC,sBAAsB,SAAW;IACjD,mDAAmD;IACnD,MAAM,CAAC,QAAQ,CAAC,mBAAmB,SAAW;IAE9C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAS;IAGhC,OAAO,CAAC,cAAc,CAAmE;IAGzF,OAAO,CAAC,cAAc,CAA2C;IACjE,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAA4D;IAC7E,OAAO,CAAC,YAAY,CAGlB;IAEF,OAAO,CAAC,IAAI,CAAQ;gBAGlB,GAAG,EAAE,GAAG,EACS,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,eAAe,EAC1B,KAAK,GAAE,MAAM,MAAiB;IAMjD;;;OAGG;IACH,WAAW,IAAI,OAAO;IAiBtB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B,yFAAyF;IACzF,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,YAAY;IAiBpB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAgDzB;;;;;;;;OAQG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BtH;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CA+BtD"}

package/dist/matterEnergy.js

@@ -0,0 +1,332 @@
+"use strict";
+/**
+ * matterEnergy.ts
+ *
+ * Publishes the EAGLE grid meter to Matter controllers as a single
+ * bidirectional ElectricalSensor reporting live power and cumulative /
+ * periodic energy, so it feeds the Apple Home Energy view (iOS 27+).
+ *
+ * Background
+ * ----------
+ * Apple Home's Energy view is driven by Matter electrical-measurement
+ * clusters, not by classic HomeKit/HAP characteristics. HAP has no native
+ * power/energy characteristic, so the Eve custom characteristics this plugin
+ * also exposes (see eveCharacteristics.ts) are only ever read by Eve-class
+ * apps and never populate the native Energy tile.
+ *
+ * Device type: ElectricalSensor, not OnOffOutlet
+ * -----------------------------------------------
+ * A pure metering device type like ElectricalSensor has no actionable
+ * primary cluster, so its tile in the Home app shows "Not Supported" as its
+ * headline status. That's an accepted tradeoff here: the meter is not
+ * actually controllable, and an on/off state would only ever be a workaround
+ * for the tile headline — the wattage still rolls into the Home aggregate
+ * and (via PeriodicEnergy, below) into this accessory's own Energy-view
+ * attribution either way.
+ *
+ *   powerW    -> electricalPowerMeasurement.activePower                        (mW, signed)
+ *   energyKWh -> electricalEnergyMeasurement.cumulativeEnergyImported.energy   (mWh)
+ *             and .cumulativeEnergyExported.energy, since the grid meter is
+ *             bidirectional (see EnergyDirection below).
+ *
+ * Matter expresses power in milliwatts and energy in milliwatt-hours, hence
+ * the x1000 / x1,000,000 conversions. cumulativeEnergyImported/Exported are
+ * themselves structs (EnergyMeasurementStruct — { energy, startTimestamp?,
+ * endTimestamp?, ... }), not plain numbers: Homebridge's updateAccessoryState()
+ * accepts and normalizes a flat number for convenience, but the *initial*
+ * state passed at registration goes straight to matter.js's struct-typed
+ * attribute and must already be an object, or registration fails with
+ * "Cannot manage number because it is not a struct".
+ *
+ * Homebridge derives the mandatory cluster attributes (powerMode, accuracy,
+ * numberOfMeasurementTypes) and the feature-gated ElectricalEnergyMeasurement
+ * features from the declared state — declaring `cumulativeEnergyImported`
+ * selects the ImportedEnergy + CumulativeEnergy features, `cumulativeEnergyExported`
+ * selects ExportedEnergy + CumulativeEnergy, and both together (for a
+ * bidirectional meter) select both pairs at once. No voltage/current data is
+ * available from the EAGLE's local API, so only activePower is declared;
+ * voltage/activeCurrent are optional per the Matter spec and are simply
+ * omitted.
+ *
+ * Imported vs. exported energy is always two separate attributes
+ * ------------------------------------------------------------
+ * `activePower` is a signed attribute (positive = importing, negative =
+ * exporting), so this single bidirectional meter can report live direction
+ * with one accessory. Cumulative/periodic *energy* has no equivalent signed
+ * "net" attribute, though: Imported and Exported are distinct lifetime
+ * running totals per the Matter spec (you don't want a day's export and
+ * import cancelling each other out), so the meter declares both
+ * `cumulativeEnergyImported` and `cumulativeEnergyExported` (and their
+ * periodic counterparts) together on the same cluster. This is how the grid
+ * meter is published as a single Matter accessory even though it remains two
+ * separate accessories in Eve/HomeKit (Grid Meter - Import / Grid Meter -
+ * Export) when `showExportMeter` is enabled, since that split is purely
+ * about Eve's inability to represent a negative watt value, not a Matter
+ * limitation.
+ *
+ * Cumulative vs. periodic energy
+ * ------------------------------
+ * Alongside the cumulative (lifetime) total, this module also declares the
+ * PeriodicEnergy feature (`periodicEnergyImported`/`periodicEnergyExported`)
+ * — a per-interval delta with its own start/end timestamps. Per prior art in
+ * homebridge-shelly-matter (github.com/keremerkan/homebridge-shelly-matter,
+ * shellyAccessory.ts), this is what drives Apple Home's per-device energy
+ * attribution in the Energy view, not the cumulative total alone. Matter
+ * features compose once at registration, so PeriodicEnergy must already be
+ * present in the *initial* cluster state passed to registerPlatformAccessories()
+ * — declaring it for the first time in a later updateAccessoryState() call
+ * would not retroactively add the feature. register() therefore seeds a
+ * zero-energy periodic fragment (no timestamps yet).
+ *
+ * Event rate
+ * ----------
+ * Homebridge routes every energy field passed to updateAccessoryState() through
+ * matter.js setMeasurement(), which records a CumulativeEnergyMeasured or
+ * PeriodicEnergyMeasured event for each one. Sending both on every poll
+ * (default 15s) produced events that almost always repeated the previous
+ * total or reported 0 energy, so update() includes each field only when it
+ * carries news:
+ *
+ * - Cumulative: when the total (in mWh) has changed since the last one sent,
+ *   or CUMULATIVE_HEARTBEAT_S has passed, so controllers still get a periodic
+ *   heartbeat while the meter is idle.
+ * - Periodic: energy is accumulated across polls (per-poll deltas, so a meter
+ *   counter that steps backwards doesn't produce a negative period) and
+ *   emitted once per PERIODIC_INTERVAL_S, with start/end timestamps covering
+ *   the whole period. If the previous period was idle (zero energy) and energy
+ *   starts flowing, the period is emitted immediately and a new one starts, so
+ *   a new session starts reporting promptly instead of up to 15 minutes later.
+ *
+ * The periodic baseline is taken from the first real poll, not from the
+ * placeholder readings register() is called with. The first update() after
+ * registration always sends both fields, as before.
+ *
+ * Requirements
+ * ------------
+ * - Homebridge 2.4.0+
+ * - Matter enabled on this plugin's child bridge (Homebridge UI ->
+ *   plugin settings -> Bridge Settings -> enable Matter)
+ * - iOS/iPadOS 27+ on the device used to view the Apple Home Energy view
+ *
+ * Everything here is feature-detected and guarded: on a Homebridge build
+ * without the Matter API, or with Matter disabled, isSupported() returns
+ * false and the plugin runs HAP/Eve-only exactly as before.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MatterEnergyBridge = void 0;
+const settings_1 = require("./settings");
+/** Matter expresses power in milliwatts. */
+function wToMilliW(value) {
+    const n = Number(value);
+    return Number.isFinite(n) ? Math.round(n * 1000) : 0;
+}
+/** Matter expresses energy in milliwatt-hours; EAGLE readings are in kWh. */
+function kWhToMilliWh(value) {
+    const n = Number(value);
+    return Number.isFinite(n) ? Math.round(Math.max(0, n) * 1000000) : 0;
+}
+const ENERGY_KINDS = {
+    imported: ['imported'],
+    exported: ['exported'],
+    bidirectional: ['imported', 'exported'],
+};
+class MatterEnergyBridge {
+    constructor(api, log, direction, nowMs = Date.now) {
+        this.log = log;
+        this.direction = direction;
+        this.nowMs = nowMs;
+        this.uuid = null;
+        this.registered = false;
+        this.warnedUpdate = false;
+        this.sentFirstUpdate = false;
+        // Cumulative energy last sent (mWh) and when.
+        this.lastCumulative = null;
+        // Periodic-energy bookkeeping — see "Event rate" at the top of this file.
+        this.lastReadingKWh = null;
+        this.periodStartS = 0;
+        this.periodKWh = { imported: 0, exported: 0 };
+        this.lastPeriodic = {
+            imported: { energy: 0 },
+            exported: { energy: 0 },
+        };
+        // True while the last emitted period carried no energy (and at startup).
+        this.idle = true;
+        this.api = api;
+        this.kinds = ENERGY_KINDS[direction];
+    }
+    /**
+     * Whether this Homebridge build exposes everything needed to publish this
+     * meter. Logs at debug level so unsupported builds stay quiet.
+     */
+    isSupported() {
+        const matter = this.api.matter;
+        if (!matter) {
+            this.log.debug('[matter] api.matter unavailable — Matter energy export disabled. Requires Homebridge 2.4.0+ with Matter enabled on this plugin\'s child bridge.');
+            return false;
+        }
+        if (!matter.deviceTypes?.ElectricalSensor) {
+            this.log.debug('[matter] api.matter.deviceTypes.ElectricalSensor unavailable — Matter energy export disabled. Requires a newer Homebridge build.');
+            return false;
+        }
+        if (typeof matter.registerPlatformAccessories !== 'function' || typeof matter.updateAccessoryState !== 'function') {
+            this.log.debug('[matter] Matter registration/update API unavailable — Matter energy export disabled.');
+            return false;
+        }
+        return true;
+    }
+    nowS() {
+        return Math.floor(this.nowMs() / 1000);
+    }
+    static readingsByKind(r) {
+        return { imported: r.importedEnergyKWh ?? 0, exported: r.exportedEnergyKWh ?? 0 };
+    }
+    /** Initial cluster state for register(): every energy field, periodic seeded at zero. */
+    buildInitialClusters(r) {
+        const kWh = MatterEnergyBridge.readingsByKind(r);
+        const mWh = { imported: kWhToMilliWh(kWh.imported), exported: kWhToMilliWh(kWh.exported) };
+        this.lastCumulative = { mWh, timeS: this.nowS() };
+        return {
+            electricalPowerMeasurement: { activePower: wToMilliW(r.powerW) },
+            electricalEnergyMeasurement: this.energyFields(mWh, true),
+        };
+    }
+    energyFields(cumulativeMWh, includePeriodic) {
+        const out = {};
+        for (const kind of this.kinds) {
+            const suffix = kind === 'imported' ? 'Imported' : 'Exported';
+            if (cumulativeMWh) {
+                out[`cumulativeEnergy${suffix}`] = { energy: cumulativeMWh[kind] };
+            }
+            if (includePeriodic) {
+                out[`periodicEnergy${suffix}`] = this.lastPeriodic[kind];
+            }
+        }
+        return out;
+    }
+    /**
+     * Decide which energy fields this poll should send, updating the cumulative
+     * and periodic bookkeeping. Returns an empty object when nothing is due.
+     */
+    buildEnergyUpdate(r) {
+        const nowS = this.nowS();
+        const kWh = MatterEnergyBridge.readingsByKind(r);
+        const first = !this.sentFirstUpdate;
+        this.sentFirstUpdate = true;
+        // Periodic: accumulate this poll's delta, emit at the end of a period or
+        // as soon as energy starts flowing after an idle period.
+        let emitPeriodic = false;
+        if (this.lastReadingKWh === null) {
+            this.periodStartS = nowS;
+        }
+        else {
+            for (const kind of this.kinds) {
+                this.periodKWh[kind] += Math.max(0, kWh[kind] - this.lastReadingKWh[kind]);
+            }
+            const hasEnergy = this.kinds.some((k) => kWhToMilliWh(this.periodKWh[k]) > 0);
+            const periodOver = nowS - this.periodStartS >= MatterEnergyBridge.PERIODIC_INTERVAL_S;
+            if (periodOver || (this.idle && hasEnergy)) {
+                emitPeriodic = true;
+                for (const kind of this.kinds) {
+                    this.lastPeriodic[kind] = {
+                        energy: kWhToMilliWh(this.periodKWh[kind]),
+                        startTimestamp: this.periodStartS,
+                        endTimestamp: nowS,
+                    };
+                    this.periodKWh[kind] = 0;
+                }
+                this.idle = !hasEnergy;
+                this.periodStartS = nowS;
+            }
+        }
+        this.lastReadingKWh = kWh;
+        // Cumulative: send on change or heartbeat.
+        const mWh = { imported: kWhToMilliWh(kWh.imported), exported: kWhToMilliWh(kWh.exported) };
+        const last = this.lastCumulative;
+        const sendCumulative = first ||
+            last === null ||
+            this.kinds.some((k) => mWh[k] !== last.mWh[k]) ||
+            nowS - last.timeS >= MatterEnergyBridge.CUMULATIVE_HEARTBEAT_S;
+        if (sendCumulative) {
+            this.lastCumulative = { mWh, timeS: nowS };
+        }
+        return this.energyFields(sendCumulative ? mWh : null, first || emitPeriodic);
+    }
+    /**
+     * Register this meter as a Matter electrical sensor.
+     *
+     * @param seedKey - unique per-meter key used to derive this accessory's
+     * Matter UUID, distinct from the HAP accessory's UUID
+     * @param displayName
+     * @param serialNumber
+     * @param readings - initial readings to seed the clusters with
+     */
+    async register(seedKey, displayName, serialNumber, readings) {
+        if (!this.isSupported())
+            return false;
+        const matter = this.api.matter;
+        this.uuid = matter.uuid.generate(`${settings_1.PLUGIN_NAME}:matter:${seedKey}`);
+        const accessory = {
+            UUID: this.uuid,
+            displayName,
+            deviceType: matter.deviceTypes.ElectricalSensor,
+            serialNumber,
+            manufacturer: 'Rainforest Automation',
+            model: 'EAGLE-3',
+            clusters: this.buildInitialClusters(readings),
+        };
+        try {
+            await matter.registerPlatformAccessories(settings_1.PLUGIN_NAME, settings_1.PLATFORM_NAME, [accessory]);
+            this.registered = true;
+            this.log.info(`[matter] Published "${displayName}" as a Matter electrical sensor — live power should feed the Apple Home Energy view.`);
+            return true;
+        }
+        catch (err) {
+            this.log.warn(`[matter] Failed to register Matter accessory for "${displayName}" (${err instanceof Error ? err.message : err}). Continuing with HomeKit/Eve only.`);
+            this.registered = false;
+            return false;
+        }
+    }
+    /**
+     * Push fresh readings to the registered Matter accessory. No-op until
+     * registration has succeeded.
+     */
+    async update(readings) {
+        if (!this.registered || !this.uuid)
+            return;
+        const matter = this.api.matter;
+        if (!matter)
+            return;
+        const energy = this.buildEnergyUpdate(readings);
+        try {
+            const updates = [
+                matter.updateAccessoryState(this.uuid, 'electricalPowerMeasurement', {
+                    activePower: wToMilliW(readings.powerW),
+                }),
+            ];
+            // Every energy field sent records a Matter event, so skip the call
+            // entirely when nothing is due.
+            if (Object.keys(energy).length > 0) {
+                updates.push(matter.updateAccessoryState(this.uuid, 'electricalEnergyMeasurement', energy));
+            }
+            await Promise.all(updates);
+        }
+        catch (err) {
+            // Log the first failure at warn, the rest at debug, so a persistently
+            // unhappy Matter server can't flood the log on every poll.
+            const message = `[matter] Failed to update Matter state: ${err instanceof Error ? err.message : err}`;
+            if (!this.warnedUpdate) {
+                this.warnedUpdate = true;
+                this.log.warn(message);
+            }
+            else {
+                this.log.debug(message);
+            }
+        }
+    }
+}
+exports.MatterEnergyBridge = MatterEnergyBridge;
+/** Re-send an unchanged cumulative total at least this often. */
+MatterEnergyBridge.CUMULATIVE_HEARTBEAT_S = 15 * 60;
+/** Length of one PeriodicEnergyMeasured period. */
+MatterEnergyBridge.PERIODIC_INTERVAL_S = 15 * 60;
+//# sourceMappingURL=matterEnergy.js.map

package/dist/matterEnergy.js.map

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

package/dist/platform.d.ts

@@ -1,5 +1,8 @@
 import { API, Characteristic, DynamicPlatformPlugin, Logger, PlatformAccessory, PlatformConfig, Service } from 'homebridge';
 import { EveChars } from './eveCharacteristics';
+import { EveUnit, EveUpdateThrottle, UpdatePolicyOptions } from './updatePolicy';
+import { PowerSwitch } from './powerSwitch';
+import { EveCharClass } from './eveCharacteristics';
 export declare class EAGLEPlatform implements DynamicPlatformPlugin {
     readonly log: Logger;
     readonly api: API;
@@ -10,14 +13,24 @@ export declare class EAGLEPlatform implements DynamicPlatformPlugin {
     readonly meterName: string;
     readonly showExportMeter: boolean;
     readonly exportMeterName: string;
+    readonly matterEnabled: boolean;
+    readonly updatePolicy: UpdatePolicyOptions;
+    readonly eveThrottle: EveUpdateThrottle;
+    private readonly switchStats;
     private readonly client;
     private readonly pollIntervalMs;
     private gridMeterAccessory?;
     private exportMeterAccessory?;
+    private gridMatterBridge?;
     private pollTimer?;
+    private throttleStatsTimer?;
     private pollInFlight;
     private backedOff;
     constructor(log: Logger, config: PlatformConfig, api: API);
+    /** Push an Eve power/energy value, subject to the evePowerUpdates mode. */
+    updateEve(service: Service, characteristic: EveCharClass, key: string, value: number, unit: EveUnit): void;
+    /** On/off state for a power-derived On characteristic, with deadband and hold. */
+    createPowerSwitch(key: string): PowerSwitch;
     configureAccessory(accessory: PlatformAccessory): void;
     private discoverDevices;
     private registerOrRestoreAccessory;

package/dist/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,cAAc,EACd,qBAAqB,EACrB,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,OAAO,EACR,MAAM,YAAY,CAAC;AAMpB,OAAO,EAA4B,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAO1E,qBAAa,aAAc,YAAW,qBAAqB;aAoBvC,GAAG,EAAE,MAAM;aAEX,GAAG,EAAE,GAAG;IArB1B,SAAgB,OAAO,EAAE,OAAO,OAAO,CAAC;IACxC,SAAgB,cAAc,EAAE,OAAO,cAAc,CAAC;IAEtD,SAAgB,WAAW,EAAE,iBAAiB,EAAE,CAAM;IACtD,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,eAAe,EAAE,OAAO,CAAC;IACzC,SAAgB,eAAe,EAAE,MAAM,CAAC;IAExC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,oBAAoB,CAAC,CAAuB;IACpD,OAAO,CAAC,SAAS,CAAC,CAAiC;IACnD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAS;gBAGR,GAAG,EAAE,MAAM,EAC3B,MAAM,EAAE,cAAc,EACN,GAAG,EAAE,GAAG;IAyD1B,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAKtD,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,0BAA0B;IAqDlC,OAAO,CAAC,YAAY;IA6CpB,OAAO,CAAC,YAAY;CAOrB"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,cAAc,EACd,qBAAqB,EACrB,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,OAAO,EACR,MAAM,YAAY,CAAC;AAMpB,OAAO,EAA4B,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAoC,MAAM,gBAAgB,CAAC;AACnH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAQpD,qBAAa,aAAc,YAAW,qBAAqB;aAgCvC,GAAG,EAAE,MAAM;aAEX,GAAG,EAAE,GAAG;IAjC1B,SAAgB,OAAO,EAAE,OAAO,OAAO,CAAC;IACxC,SAAgB,cAAc,EAAE,OAAO,cAAc,CAAC;IAEtD,SAAgB,WAAW,EAAE,iBAAiB,EAAE,CAAM;IACtD,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,eAAe,EAAE,OAAO,CAAC;IACzC,SAAgB,eAAe,EAAE,MAAM,CAAC;IACxC,SAAgB,aAAa,EAAE,OAAO,CAAC;IAEvC,SAAgB,YAAY,EAAE,mBAAmB,CAAC;IAClD,SAAgB,WAAW,EAAE,iBAAiB,CAAC;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IAEjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,oBAAoB,CAAC,CAAuB;IAMpD,OAAO,CAAC,gBAAgB,CAAC,CAAqB;IAC9C,OAAO,CAAC,SAAS,CAAC,CAAiC;IACnD,OAAO,CAAC,kBAAkB,CAAC,CAAiC;IAC5D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAS;gBAGR,GAAG,EAAE,MAAM,EAC3B,MAAM,EAAE,cAAc,EACN,GAAG,EAAE,GAAG;IAoE1B,2EAA2E;IAC3E,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAM1G,kFAAkF;IAClF,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAS3C,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAKtD,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,0BAA0B;IAuElC,OAAO,CAAC,YAAY;IAyEpB,OAAO,CAAC,YAAY;CAOrB"}