homebridge-generac 0.1.0-beta.1

package/dist/exercise.d.ts

@@ -0,0 +1,42 @@
+/** "HH:MM" to minutes past midnight, or null when malformed. */
+export declare function parseHHMM(value: string | null | undefined): number | null;
+/** The watch window opens this many minutes before the exercise time and closes this many after it. */
+export declare const WATCH_BEFORE_MINUTES = 2;
+export declare const WATCH_AFTER_MINUTES = 20;
+/**
+ * True from `exerciseMinutes - 2` (inclusive) to `exerciseMinutes + 20` (exclusive), every day, in the host's
+ * local time zone. A window that straddles midnight (an exercise at 00:01 or 23:50) is handled.
+ */
+export declare function inWatchWindow(exerciseMinutes: number, now: Date): boolean;
+/** Milliseconds until the next watch window opens; 0 while inside one. */
+export declare function msUntilWatchWindow(exerciseMinutes: number, now: Date): number;
+export interface ExerciseObservation {
+    /** Whether the Exercising sensor should be open after this observation. */
+    open: boolean;
+    /** True when this observation triggered the sensor (live status 3, or a newer lastExerciseAt). */
+    triggered: boolean;
+    /** True when lastExerciseAt advanced past the persisted value (the retroactive path). */
+    retroactive: boolean;
+}
+/**
+ * The Exercising sensor's state for one generator (SPEC section 7, service 6).
+ *
+ * The sensor opens when a poll observes status 3, or when `lastExerciseAt` moves to a newer value than the
+ * one persisted in state.json. It stays open until the status has left 3 and the hold has elapsed since the
+ * last trigger. On first run (nothing persisted) the current `lastExerciseAt` is recorded without opening.
+ */
+export declare class ExerciseTracker {
+    private readonly holdMs;
+    /** The newest lastExerciseAt seen, as epoch ms; null when the unit has never reported one; undefined before the first observation. */
+    private recorded;
+    private lastTriggerAt;
+    private exercisingNow;
+    constructor(persisted: string | null | undefined, holdMs: number);
+    /** The value to persist in state.json: the newest lastExerciseAt seen, as an ISO string. */
+    get lastExerciseAt(): string | null;
+    observe(status: number, lastExerciseAt: Date | null, now: number): ExerciseObservation;
+    /** Whether the sensor is open at `now`: exercising, or within the hold since the last trigger. */
+    isOpen(now: number): boolean;
+    /** Milliseconds until the hold expires, or null when nothing is held (or the status still keeps it open). */
+    holdRemaining(now: number): number | null;
+}

package/dist/exercise.js

@@ -0,0 +1,115 @@
+/**
+ * Exercise detection and the watch window (SPEC sections 7 and 8). Pure: no timers, no HAP, so the
+ * platform tests drive it with fixed clocks.
+ */
+import { STATUS } from './types.js';
+/** "HH:MM" to minutes past midnight, or null when malformed. */
+export function parseHHMM(value) {
+    if (!value) {
+        return null;
+    }
+    const m = /^(\d{1,2}):(\d{2})$/.exec(value.trim());
+    if (!m) {
+        return null;
+    }
+    const h = Number(m[1]);
+    const min = Number(m[2]);
+    if (h > 23 || min > 59) {
+        return null;
+    }
+    return h * 60 + min;
+}
+/** The watch window opens this many minutes before the exercise time and closes this many after it. */
+export const WATCH_BEFORE_MINUTES = 2;
+export const WATCH_AFTER_MINUTES = 20;
+const DAY_MINUTES = 24 * 60;
+/** Minutes past local midnight of `now`, with the seconds as a fraction. */
+function localMinutes(now) {
+    return now.getHours() * 60 + now.getMinutes() + now.getSeconds() / 60 + now.getMilliseconds() / 60000;
+}
+/**
+ * True from `exerciseMinutes - 2` (inclusive) to `exerciseMinutes + 20` (exclusive), every day, in the host's
+ * local time zone. A window that straddles midnight (an exercise at 00:01 or 23:50) is handled.
+ */
+export function inWatchWindow(exerciseMinutes, now) {
+    const offset = (localMinutes(now) - (exerciseMinutes - WATCH_BEFORE_MINUTES) + DAY_MINUTES) % DAY_MINUTES;
+    return offset < WATCH_BEFORE_MINUTES + WATCH_AFTER_MINUTES;
+}
+/** Milliseconds until the next watch window opens; 0 while inside one. */
+export function msUntilWatchWindow(exerciseMinutes, now) {
+    if (inWatchWindow(exerciseMinutes, now)) {
+        return 0;
+    }
+    const start = exerciseMinutes - WATCH_BEFORE_MINUTES;
+    const until = (start - localMinutes(now) + DAY_MINUTES) % DAY_MINUTES;
+    return Math.max(1, Math.round(until * 60000));
+}
+/**
+ * The Exercising sensor's state for one generator (SPEC section 7, service 6).
+ *
+ * The sensor opens when a poll observes status 3, or when `lastExerciseAt` moves to a newer value than the
+ * one persisted in state.json. It stays open until the status has left 3 and the hold has elapsed since the
+ * last trigger. On first run (nothing persisted) the current `lastExerciseAt` is recorded without opening.
+ */
+export class ExerciseTracker {
+    holdMs;
+    /** The newest lastExerciseAt seen, as epoch ms; null when the unit has never reported one; undefined before the first observation. */
+    recorded;
+    lastTriggerAt = null;
+    exercisingNow = false;
+    constructor(persisted, holdMs) {
+        this.holdMs = holdMs;
+        if (persisted === undefined) {
+            this.recorded = undefined;
+        }
+        else if (persisted === null) {
+            this.recorded = null;
+        }
+        else {
+            const t = Date.parse(persisted);
+            this.recorded = Number.isNaN(t) ? null : t;
+        }
+    }
+    /** The value to persist in state.json: the newest lastExerciseAt seen, as an ISO string. */
+    get lastExerciseAt() {
+        return typeof this.recorded === 'number' ? new Date(this.recorded).toISOString() : null;
+    }
+    observe(status, lastExerciseAt, now) {
+        let triggered = false;
+        let retroactive = false;
+        this.exercisingNow = status === STATUS.EXERCISING;
+        if (this.exercisingNow) {
+            triggered = true;
+        }
+        const seen = lastExerciseAt ? lastExerciseAt.getTime() : null;
+        if (this.recorded === undefined) {
+            // First run: remember what the unit reports without opening the sensor for an exercise that may be days old.
+            this.recorded = seen;
+        }
+        else if (seen !== null && (this.recorded === null || seen > this.recorded)) {
+            this.recorded = seen;
+            triggered = true;
+            retroactive = true;
+        }
+        if (triggered) {
+            this.lastTriggerAt = now;
+        }
+        return { open: this.isOpen(now), triggered, retroactive };
+    }
+    /** Whether the sensor is open at `now`: exercising, or within the hold since the last trigger. */
+    isOpen(now) {
+        if (this.exercisingNow) {
+            return true;
+        }
+        return this.lastTriggerAt !== null && now - this.lastTriggerAt < this.holdMs;
+    }
+    /** Milliseconds until the hold expires, or null when nothing is held (or the status still keeps it open). */
+    holdRemaining(now) {
+        if (this.lastTriggerAt === null) {
+            return null;
+        }
+        const remaining = this.lastTriggerAt + this.holdMs - now;
+        return remaining > 0 ? remaining : null;
+    }
+}
+//# sourceMappingURL=exercise.js.map

package/dist/exercise.js.map

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

package/dist/files.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Write a file atomically: write to a temp file in the same directory, fsync,
+ * then rename over the target. A reader never sees a half-written file.
+ */
+export declare function writeFileAtomic(file: string, data: string, mode: number): void;

package/dist/files.js

@@ -0,0 +1,28 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Write a file atomically: write to a temp file in the same directory, fsync,
+ * then rename over the target. A reader never sees a half-written file.
+ */
+export function writeFileAtomic(file, data, mode) {
+    const dir = path.dirname(file);
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const tmp = path.join(dir, `.${path.basename(file)}.${process.pid}.${Date.now()}.tmp`);
+    const fd = fs.openSync(tmp, 'w', mode);
+    try {
+        fs.writeSync(fd, data);
+        fs.fsyncSync(fd);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    try {
+        fs.chmodSync(tmp, mode);
+        fs.renameSync(tmp, file);
+    }
+    catch (err) {
+        fs.rmSync(tmp, { force: true });
+        throw err;
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY,EAAE,IAAY;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACvF,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACvB,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxB,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

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 { GeneracPlatform } from './platform.js';
+import { PLATFORM_NAME } from './settings.js';
+export default (api) => {
+    api.registerPlatform(PLATFORM_NAME, GeneracPlatform);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,eAAe,CAAC,GAAQ,EAAQ,EAAE;IAChC,GAAG,CAAC,gBAAgB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;AACvD,CAAC,CAAC"}

package/dist/model.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Pure mapping from Generac's raw payloads to the state the accessory layer
+ * consumes. No I/O, no HAP, so it is fully unit-testable against fixtures.
+ */
+import { type RawApparatus, type RawApparatusDetail, type RawProperty } from './types.js';
+export interface FaultOptions {
+    faultOnStopped: boolean;
+    faultOnDisconnected: boolean;
+}
+export interface GeneratorState {
+    id: number;
+    name: string;
+    serial: string;
+    model: string;
+    status: number;
+    statusLabel: string;
+    statusText: string;
+    running: boolean;
+    exercising: boolean;
+    connected: boolean;
+    fault: boolean;
+    faultReasons: string[];
+    maintenanceDue: boolean;
+    batteryVoltage: number | null;
+    engineHours: number | null;
+    hoursOfProtection: number | null;
+    /** The API's Exercise Minutes as a 12-hour label ("10:05 AM"), for the log and the CLI. */
+    exerciseTime: string | null;
+    /** The API's Exercise Minutes as 24-hour "HH:MM", the default for the `exerciseTime` setting (SPEC section 9). */
+    exerciseTimeFromApi: string | null;
+    /** When the last exercise finished, from the eventType 42 alert (SPEC section 6); null when the payload carries another event. */
+    lastExerciseAt: Date | null;
+    fuelType: string | null;
+    outdoorTempF: number | null;
+    lastSeen: Date | null;
+}
+export declare function propByType(props: RawProperty[] | undefined, type: number): RawProperty | undefined;
+/** Generac mixes "13.6" and 17 in the same array. */
+export declare function numericProp(props: RawProperty[] | undefined, type: number): number | null;
+export declare function fuelTypeLabel(props: RawProperty[] | undefined): string | null;
+/** Exercise Minutes is minutes past midnight (605 = 10:05 AM); null when absent or out of range. */
+export declare function exerciseMinutes(props: RawProperty[] | undefined): number | null;
+/** Minutes past midnight as a 12-hour label: 605 becomes "10:05 AM". */
+export declare function minutesToLabel(m: number): string;
+/** Minutes past midnight as 24-hour "HH:MM": 605 becomes "10:05". */
+export declare function minutesToHHMM(m: number): string;
+export declare function exerciseTimeLabel(props: RawProperty[] | undefined): string | null;
+/**
+ * The last exercise, from the details payload's `alert` (SPEC section 6): its timestamp when the event type
+ * is the exercise-complete event, else null. Any other event (an alarm, a maintenance note) says nothing
+ * about exercise, so the previous value is kept by the caller rather than cleared here.
+ */
+export declare function lastExerciseFromAlert(detail: RawApparatusDetail): Date | null;
+/**
+ * User-facing fault reasons (SPEC section 11.3 D). Shared by the log line and
+ * the settings page so both show the same words.
+ */
+export declare const FAULT_REASON: {
+    readonly SWITCH_OFF: "Switch in OFF";
+    readonly WARNING_STATUS: "Warning status";
+    readonly LOST_CONNECTION: "Lost connection";
+    readonly activeAlarms: (n: number) => string;
+    readonly activeWarnings: (n: number) => string;
+    readonly alarmCode: (code: string) => string;
+};
+export declare function modelFromDetail(detail: RawApparatusDetail, list?: RawApparatus): string;
+export declare function toGeneratorState(detail: RawApparatusDetail, list: RawApparatus | undefined, opts: FaultOptions): GeneratorState;
+/**
+ * Lead-acid starting battery, approximate state of charge from resting or float
+ * voltage. Clamped: a healthy unit on float charge reads 13.4 to 13.8V.
+ */
+export declare function batteryPercent(volts: number | null): number;
+/** True when a generator is in a state worth polling faster for. */
+export declare function isActive(state: GeneratorState): boolean;

package/dist/model.js

@@ -0,0 +1,167 @@
+/**
+ * Pure mapping from Generac's raw payloads to the state the accessory layer
+ * consumes. No I/O, no HAP, so it is fully unit-testable against fixtures.
+ */
+import { EXERCISE_COMPLETE_EVENT, PROP, STATUS, STATUS_LABEL, } from './types.js';
+export function propByType(props, type) {
+    return props?.find((p) => p.type === type);
+}
+/** Generac mixes "13.6" and 17 in the same array. */
+export function numericProp(props, type) {
+    const p = propByType(props, type);
+    if (!p || p.value === null || p.value === undefined || p.value === '') {
+        return null;
+    }
+    const n = typeof p.value === 'number' ? p.value : Number(p.value);
+    return Number.isFinite(n) ? n : null;
+}
+const FUEL_TYPE_LABEL = {
+    '1': 'natural gas',
+    '2': 'propane',
+    '3': 'diesel',
+};
+export function fuelTypeLabel(props) {
+    const p = propByType(props, PROP.FUEL_TYPE);
+    if (!p || p.value === null || p.value === undefined) {
+        return null;
+    }
+    const key = String(p.value);
+    return FUEL_TYPE_LABEL[key] ?? `fuel type ${key}`;
+}
+/** Exercise Minutes is minutes past midnight (605 = 10:05 AM); null when absent or out of range. */
+export function exerciseMinutes(props) {
+    const m = numericProp(props, PROP.EXERCISE_MINUTES);
+    if (m === null || m < 0 || m >= 1440) {
+        return null;
+    }
+    return Math.floor(m);
+}
+/** Minutes past midnight as a 12-hour label: 605 becomes "10:05 AM". */
+export function minutesToLabel(m) {
+    const h24 = Math.floor(m / 60);
+    const mm = String(m % 60).padStart(2, '0');
+    const h12 = h24 % 12 === 0 ? 12 : h24 % 12;
+    return `${h12}:${mm} ${h24 < 12 ? 'AM' : 'PM'}`;
+}
+/** Minutes past midnight as 24-hour "HH:MM": 605 becomes "10:05". */
+export function minutesToHHMM(m) {
+    return `${String(Math.floor(m / 60)).padStart(2, '0')}:${String(m % 60).padStart(2, '0')}`;
+}
+export function exerciseTimeLabel(props) {
+    const m = exerciseMinutes(props);
+    return m === null ? null : minutesToLabel(m);
+}
+/**
+ * The last exercise, from the details payload's `alert` (SPEC section 6): its timestamp when the event type
+ * is the exercise-complete event, else null. Any other event (an alarm, a maintenance note) says nothing
+ * about exercise, so the previous value is kept by the caller rather than cleared here.
+ */
+export function lastExerciseFromAlert(detail) {
+    const alert = detail.alert;
+    if (!alert || alert.eventType !== EXERCISE_COMPLETE_EVENT || !alert.timestamp) {
+        return null;
+    }
+    const d = new Date(alert.timestamp);
+    return Number.isNaN(d.getTime()) ? null : d;
+}
+/**
+ * User-facing fault reasons (SPEC section 11.3 D). Shared by the log line and
+ * the settings page so both show the same words.
+ */
+export const FAULT_REASON = {
+    SWITCH_OFF: 'Switch in OFF',
+    WARNING_STATUS: 'Warning status',
+    LOST_CONNECTION: 'Lost connection',
+    activeAlarms: (n) => `${n} active alarm(s)`,
+    activeWarnings: (n) => `${n} active warning(s)`,
+    alarmCode: (code) => `Alarm code ${code}`,
+};
+export function modelFromDetail(detail, list) {
+    const desc = detail.productInfo?.find((p) => p.name === 'Description')?.value;
+    if (typeof desc === 'string' && desc.trim()) {
+        return desc.trim();
+    }
+    return list?.modelNumber ?? 'Generac generator';
+}
+export function toGeneratorState(detail, list, opts) {
+    const status = detail.apparatusStatus ?? list?.apparatusStatus ?? STATUS.UNKNOWN;
+    const connected = detail.isConnected ?? list?.isConnected ?? false;
+    const reasons = [];
+    const reason = (r) => {
+        if (!reasons.includes(r)) {
+            reasons.push(r);
+        }
+    };
+    if (status === STATUS.WARNING) {
+        reason(FAULT_REASON.WARNING_STATUS);
+    }
+    if (status === STATUS.STOPPED && opts.faultOnStopped) {
+        reason(FAULT_REASON.SWITCH_OFF);
+    }
+    if (status === STATUS.COMM_ISSUE && opts.faultOnDisconnected) {
+        reason(FAULT_REASON.LOST_CONNECTION);
+    }
+    if (!connected && opts.faultOnDisconnected) {
+        reason(FAULT_REASON.LOST_CONNECTION);
+    }
+    if (detail.showWarning) {
+        reason(FAULT_REASON.WARNING_STATUS);
+    }
+    const alarms = detail.alarms?.length ?? 0;
+    if (alarms > 0) {
+        reason(FAULT_REASON.activeAlarms(alarms));
+    }
+    const warnings = detail.warnings?.length ?? 0;
+    if (warnings > 0) {
+        reason(FAULT_REASON.activeWarnings(warnings));
+    }
+    if (detail.currentAlarm && detail.currentAlarm !== '0') {
+        reason(FAULT_REASON.alarmCode(detail.currentAlarm));
+    }
+    const minutes = exerciseMinutes(detail.properties);
+    const temp = detail.weather?.temperature;
+    let outdoorTempF = null;
+    if (temp && Number.isFinite(temp.value)) {
+        outdoorTempF = temp.unit?.toUpperCase() === 'C' ? (temp.value * 9) / 5 + 32 : temp.value;
+    }
+    return {
+        id: detail.apparatusId,
+        name: detail.name || list?.name || 'Generator',
+        serial: detail.serialNumber || list?.serialNumber || String(detail.apparatusId),
+        model: modelFromDetail(detail, list),
+        status,
+        statusLabel: detail.statusLabel || STATUS_LABEL[status] || 'Unknown',
+        statusText: detail.statusText || '',
+        running: status === STATUS.RUNNING,
+        exercising: status === STATUS.EXERCISING,
+        connected,
+        fault: reasons.length > 0,
+        faultReasons: reasons,
+        maintenanceDue: Boolean(detail.hasMaintenanceAlert) || (detail.maintenance?.length ?? 0) > 0,
+        batteryVoltage: numericProp(detail.properties, PROP.BATTERY_VOLTAGE),
+        engineHours: numericProp(detail.properties, PROP.ENGINE_HOURS),
+        hoursOfProtection: numericProp(detail.properties, PROP.HOURS_OF_PROTECTION),
+        exerciseTime: exerciseTimeLabel(detail.properties),
+        exerciseTimeFromApi: minutes === null ? null : minutesToHHMM(minutes),
+        lastExerciseAt: lastExerciseFromAlert(detail),
+        fuelType: fuelTypeLabel(detail.properties),
+        outdoorTempF,
+        lastSeen: detail.lastSeen ? new Date(detail.lastSeen) : null,
+    };
+}
+/**
+ * Lead-acid starting battery, approximate state of charge from resting or float
+ * voltage. Clamped: a healthy unit on float charge reads 13.4 to 13.8V.
+ */
+export function batteryPercent(volts) {
+    if (volts === null) {
+        return 100;
+    }
+    const pct = ((volts - 11.8) / (12.8 - 11.8)) * 100;
+    return Math.max(0, Math.min(100, Math.round(pct)));
+}
+/** True when a generator is in a state worth polling faster for. */
+export function isActive(state) {
+    return state.running || state.exercising || state.fault;
+}
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

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

package/dist/platform.d.ts

@@ -0,0 +1,117 @@
+import type { API, DynamicPlatformPlugin, Logger, PlatformAccessory, PlatformConfig } from 'homebridge';
+import { type GeneratorState } from './model.js';
+import { type ResolvedConfig } from './settings.js';
+import { type AccountState } from './state.js';
+/** How often the credentials file is re-read (SPEC section 4.4): for a sign-in while there is no working client, and for a Disconnect while there is one. */
+export declare const CREDENTIAL_CHECK_MS: number;
+/** Retry interval after `invalid_grant` (SPEC section 4.3). */
+export declare const RECONNECT_RETRY_MS: number;
+/** Backoff cap for other poll failures (SPEC section 8). */
+export declare const BACKOFF_MAX_MS: number;
+export declare class GeneracPlatform implements DynamicPlatformPlugin {
+    readonly log: Logger;
+    readonly api: API;
+    readonly config: ResolvedConfig;
+    readonly version: string;
+    /** What the accessories report as FirmwareRevision (SPEC section 7). */
+    readonly firmware: string;
+    private readonly storagePath;
+    private readonly credentialsPath;
+    private readonly attentionUuid;
+    private readonly cached;
+    private readonly generators;
+    /** Exercise detection per generator (SPEC section 7), seeded from state.json on start. */
+    private readonly trackers;
+    private readonly holdTimers;
+    /** `lastExerciseAt` per generator as state.json held it on start; a missing entry means first run for that unit. */
+    private readonly persistedExercise;
+    private others;
+    private attention;
+    private client;
+    private credentials;
+    private accountState;
+    private lastChecked;
+    private reconnectLogged;
+    private pollTimer;
+    private credentialTimer;
+    private inFlight;
+    private failures;
+    private stopped;
+    /** Delay of the most recently scheduled poll in milliseconds, for the debug log and tests. */
+    nextPollMs: number | null;
+    /** The clock, replaceable by tests (the hold timer and the watch window read it). */
+    now: () => number;
+    constructor(log: Logger, rawConfig: PlatformConfig, api: API);
+    configureAccessory(accessory: PlatformAccessory): void;
+    /** Account state as the settings page sees it. */
+    get account(): AccountState;
+    /**
+     * Runs once Homebridge has restored cached accessories. Public so tests can
+     * await the first poll.
+     */
+    start(): Promise<void>;
+    shutdown(): void;
+    /**
+     * The settings page's Reset dialog leaves a marker (SPEC section 11.3 E, "Removes every generator and its sensors
+     * from the Home app"): every cached accessory goes on this start, once, and the marker with it.
+     */
+    private applyResetMarker;
+    private setupAttention;
+    private findCredentials;
+    private static signatureOf;
+    /**
+     * Load credentials when a usable file exists and differs from what is loaded
+     * (compared by `created_at`). Returns true when a new client was created.
+     */
+    private loadCredentials;
+    private scheduleCredentialCheck;
+    /**
+     * Re-read the credentials file. When a new or changed file is usable, poll
+     * immediately so a sign-in takes effect without a restart; when the file the
+     * client came from is gone (Disconnect), stop. Runs every 60 s. Public for tests.
+     */
+    checkCredentials(): Promise<void>;
+    /**
+     * The credentials file disappeared (the settings page's Disconnect, or a hand delete): stop polling, drop the
+     * client, report not_connected, mark the sensors not responding, and keep checking the file every 60 s.
+     */
+    private credentialsRemoved;
+    private schedule;
+    /** One poll: /Apparatus/list, then details for each generator. Public for tests. */
+    poll(): Promise<void>;
+    private doPoll;
+    /**
+     * The delay until the next poll (SPEC section 8): the active interval while any generator is active or the
+     * exercise watch window is open, else the idle interval, cut short so the next poll lands when the window opens.
+     */
+    private nextInterval;
+    /**
+     * The exercise time the watch window follows, as minutes past local midnight: the `exerciseTime` setting,
+     * else the first generator's Exercise Minutes from the API, else null (no window).
+     */
+    exerciseMinutes(): number | null;
+    /** Returns true when the generator is in an "active" state that warrants faster polling. */
+    private syncGenerator;
+    /** A debug capture of the raw payload (SPEC section 12). Never blocks a poll: a write failure is warned about once. */
+    private capture;
+    private loadPersistedExercise;
+    /** Feeds one poll into the generator's tracker and drives the sensor. Returns true on a retroactive detection. */
+    private observeExercise;
+    /** Closes the sensor when the hold runs out between polls. */
+    private scheduleHoldExpiry;
+    /** Re-evaluates every Exercising sensor against the clock. Public for tests, which drive the clock by hand. */
+    refreshExerciseSensors(): void;
+    /** The last state of every generator, for the state file and tests. */
+    get generatorStates(): GeneratorState[];
+    /** The generator states as the state file carries them, with the persisted `lastExerciseAt` per unit. */
+    private snapshots;
+    private writeState;
+    /**
+     * Debug lines. Sent through log.debug so Homebridge's own -D shows them;
+     * with the plugin's `debug` setting on they are raised to info so they show
+     * without -D, since Homebridge drops log.debug output otherwise.
+     */
+    private debug;
+    private readonly onceKeys;
+    private once;
+}