homebridge-generac 0.1.0-beta.1

package/dist/settings.d.ts

@@ -0,0 +1,75 @@
+export declare const PLATFORM_NAME = "Generac";
+export declare const PLUGIN_NAME = "homebridge-generac";
+/** Display-name override for one generator, keyed by Mobile Link apparatusId. */
+export interface GeneratorOverride {
+    apparatusId: number;
+    name: string;
+}
+/** Keys accepted in config.json. See SPEC section 9. */
+export interface GeneracConfig {
+    name?: string;
+    credentialsPath?: string;
+    pollIdleMinutes?: number;
+    pollActiveSeconds?: number;
+    batteryLowVoltage?: number;
+    faultOnStopped?: boolean;
+    faultOnDisconnected?: boolean;
+    attentionSensor?: boolean;
+    exerciseSensor?: boolean;
+    exerciseTime?: string;
+    exerciseHoldMinutes?: number;
+    debug?: boolean;
+    generators?: GeneratorOverride[];
+}
+export interface ResolvedConfig {
+    pollIdleMinutes: number;
+    pollActiveSeconds: number;
+    batteryLowVoltage: number;
+    faultOnStopped: boolean;
+    faultOnDisconnected: boolean;
+    attentionSensor: boolean;
+    exerciseSensor: boolean;
+    /** 24-hour "HH:MM", or undefined to use the API's Exercise Minutes (SPEC section 9). Malformed values read as undefined. */
+    exerciseTime: string | undefined;
+    exerciseHoldMinutes: number;
+    debug: boolean;
+    generators: GeneratorOverride[];
+}
+export declare const POLL_IDLE_MINUTES_DEFAULT = 10;
+export declare const POLL_IDLE_MINUTES_MIN = 2;
+export declare const POLL_ACTIVE_SECONDS_DEFAULT = 90;
+export declare const POLL_ACTIVE_SECONDS_MIN = 60;
+export declare const EXERCISE_HOLD_MINUTES_DEFAULT = 5;
+export declare const EXERCISE_HOLD_MINUTES_MIN = 1;
+/** A 24-hour "HH:MM" time as the settings page and config.json carry it. */
+export declare const HHMM_PATTERN: RegExp;
+/** The `exerciseTime` setting: "HH:MM" trimmed, or undefined when absent, blank or malformed. */
+export declare function exerciseTimeSetting(value: unknown): string | undefined;
+export declare function resolveConfig(c: GeneracConfig): ResolvedConfig;
+/** The display name for a generator: the configured override when present, else the Mobile Link name. */
+export declare function displayNameFor(config: ResolvedConfig, apparatusId: number, mobileLinkName: string): string;
+/** The plugin's data directory under the Homebridge storage path. */
+export declare function dataDir(storagePath: string): string;
+/** Where the platform and the UI server write credentials (SPEC section 4.4). */
+export declare function primaryCredentialsPath(storagePath: string): string;
+/** The marker the settings page's Reset leaves under the data directory: the platform removes every cached accessory on its next start. */
+export declare const RESET_MARKER = "reset-pending";
+/** Where the platform writes its state after every poll (SPEC section 10). */
+export declare function statePath(storagePath: string): string;
+/**
+ * Where the platform looks for credentials, in priority order (SPEC section 4.4):
+ * the primary location under the Homebridge storage path, then `credentialsPath`
+ * from config when set, then the conventional ~/.homebridge location.
+ */
+export declare function credentialCandidates(storagePath: string | undefined, explicit?: string): string[];
+export declare function defaultStoragePath(): string;
+/**
+ * The numeric part of a version for HAP's FirmwareRevision (SPEC section 7): "0.1.0" for "0.1.0-beta.1".
+ * HAP truncates a pre-release suffix to "0.1", which is a different version.
+ */
+export declare function firmwareVersion(version: string): string;
+/**
+ * The plugin's own version from package.json, found by walking up from this
+ * file. Works from dist/ (published layout) and from the test build.
+ */
+export declare function pluginVersion(): string;

package/dist/settings.js

@@ -0,0 +1,115 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+export const PLATFORM_NAME = 'Generac';
+export const PLUGIN_NAME = 'homebridge-generac';
+export const POLL_IDLE_MINUTES_DEFAULT = 10;
+export const POLL_IDLE_MINUTES_MIN = 2;
+export const POLL_ACTIVE_SECONDS_DEFAULT = 90;
+export const POLL_ACTIVE_SECONDS_MIN = 60;
+export const EXERCISE_HOLD_MINUTES_DEFAULT = 5;
+export const EXERCISE_HOLD_MINUTES_MIN = 1;
+/** A 24-hour "HH:MM" time as the settings page and config.json carry it. */
+export const HHMM_PATTERN = /^([01]\d|2[0-3]):[0-5]\d$/;
+/** The `exerciseTime` setting: "HH:MM" trimmed, or undefined when absent, blank or malformed. */
+export function exerciseTimeSetting(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const v = value.trim();
+    return HHMM_PATTERN.test(v) ? v : undefined;
+}
+function finiteOr(value, fallback) {
+    const n = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(n) ? n : fallback;
+}
+export function resolveConfig(c) {
+    const overrides = Array.isArray(c.generators) ? c.generators : [];
+    return {
+        pollIdleMinutes: Math.max(POLL_IDLE_MINUTES_MIN, finiteOr(c.pollIdleMinutes, POLL_IDLE_MINUTES_DEFAULT)),
+        pollActiveSeconds: Math.max(POLL_ACTIVE_SECONDS_MIN, finiteOr(c.pollActiveSeconds, POLL_ACTIVE_SECONDS_DEFAULT)),
+        batteryLowVoltage: finiteOr(c.batteryLowVoltage, 12.0),
+        faultOnStopped: c.faultOnStopped ?? true,
+        faultOnDisconnected: c.faultOnDisconnected ?? false,
+        attentionSensor: c.attentionSensor ?? false,
+        exerciseSensor: c.exerciseSensor ?? true,
+        exerciseTime: exerciseTimeSetting(c.exerciseTime),
+        exerciseHoldMinutes: Math.max(EXERCISE_HOLD_MINUTES_MIN, finiteOr(c.exerciseHoldMinutes, EXERCISE_HOLD_MINUTES_DEFAULT)),
+        debug: c.debug ?? false,
+        generators: overrides
+            .filter((g) => g && Number.isFinite(Number(g.apparatusId)) && typeof g.name === 'string' && g.name.trim() !== '')
+            .map((g) => ({ apparatusId: Number(g.apparatusId), name: g.name.trim() })),
+    };
+}
+/** The display name for a generator: the configured override when present, else the Mobile Link name. */
+export function displayNameFor(config, apparatusId, mobileLinkName) {
+    const override = config.generators.find((g) => g.apparatusId === apparatusId);
+    return override ? override.name : mobileLinkName;
+}
+/** The plugin's data directory under the Homebridge storage path. */
+export function dataDir(storagePath) {
+    return path.join(storagePath, PLUGIN_NAME);
+}
+/** Where the platform and the UI server write credentials (SPEC section 4.4). */
+export function primaryCredentialsPath(storagePath) {
+    return path.join(dataDir(storagePath), 'credentials.json');
+}
+/** The marker the settings page's Reset leaves under the data directory: the platform removes every cached accessory on its next start. */
+export const RESET_MARKER = 'reset-pending';
+/** Where the platform writes its state after every poll (SPEC section 10). */
+export function statePath(storagePath) {
+    return path.join(dataDir(storagePath), 'state.json');
+}
+/**
+ * Where the platform looks for credentials, in priority order (SPEC section 4.4):
+ * the primary location under the Homebridge storage path, then `credentialsPath`
+ * from config when set, then the conventional ~/.homebridge location.
+ */
+export function credentialCandidates(storagePath, explicit) {
+    const out = [];
+    if (storagePath) {
+        out.push(primaryCredentialsPath(storagePath));
+    }
+    if (explicit && explicit.trim()) {
+        out.push(path.resolve(explicit.trim()));
+    }
+    out.push(path.join(os.homedir(), '.homebridge', PLUGIN_NAME, 'credentials.json'));
+    return [...new Set(out)];
+}
+export function defaultStoragePath() {
+    return process.env.UIX_STORAGE_PATH || process.env.HOMEBRIDGE_STORAGE_PATH || path.join(os.homedir(), '.homebridge');
+}
+/**
+ * The numeric part of a version for HAP's FirmwareRevision (SPEC section 7): "0.1.0" for "0.1.0-beta.1".
+ * HAP truncates a pre-release suffix to "0.1", which is a different version.
+ */
+export function firmwareVersion(version) {
+    const m = /^\d+\.\d+\.\d+/.exec(version.trim());
+    return m ? m[0] : version;
+}
+/**
+ * The plugin's own version from package.json, found by walking up from this
+ * file. Works from dist/ (published layout) and from the test build.
+ */
+export function pluginVersion() {
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 5; i++) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'));
+            if (pkg.name === PLUGIN_NAME && typeof pkg.version === 'string') {
+                return pkg.version;
+            }
+        }
+        catch {
+            // keep walking
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    return '0.0.0';
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,28 @@
+import type { GeneratorState } from './model.js';
+export type AccountState = 'connected' | 'reconnect_needed' | 'not_connected';
+export interface AccountSnapshot {
+    state: AccountState;
+    email?: string;
+    lastChecked?: string;
+}
+/** GeneratorState with dates as ISO strings, so it survives JSON. `lastExerciseAt` is the platform's persisted value (SPEC section 7). */
+export type GeneratorSnapshot = Omit<GeneratorState, 'lastSeen' | 'lastExerciseAt'> & {
+    lastSeen: string | null;
+    lastExerciseAt: string | null;
+};
+export interface OtherDevice {
+    type: number;
+    name: string;
+    apparatusId: number;
+}
+export interface StateFile {
+    account: AccountSnapshot;
+    generators: GeneratorSnapshot[];
+    others: OtherDevice[];
+    updatedAt: string;
+}
+export declare function toGeneratorSnapshot(state: GeneratorState, lastExerciseAt?: string | null): GeneratorSnapshot;
+export declare function buildStateFile(account: AccountSnapshot, generators: Iterable<GeneratorSnapshot>, others: Iterable<OtherDevice>, now?: Date): StateFile;
+export declare function writeStateFile(file: string, state: StateFile): void;
+/** The state file as last written, or null when missing or unreadable. Never throws. */
+export declare function readStateFile(file: string): StateFile | null;

package/dist/state.js

@@ -0,0 +1,43 @@
+/**
+ * The state file the platform writes after every poll and the settings page
+ * reads (SPEC section 10): <storagePath>/homebridge-generac/state.json.
+ */
+import fs from 'node:fs';
+import { writeFileAtomic } from './files.js';
+export function toGeneratorSnapshot(state, lastExerciseAt) {
+    return {
+        ...state,
+        lastSeen: state.lastSeen ? state.lastSeen.toISOString() : null,
+        lastExerciseAt: lastExerciseAt !== undefined ? lastExerciseAt : state.lastExerciseAt ? state.lastExerciseAt.toISOString() : null,
+    };
+}
+export function buildStateFile(account, generators, others, now = new Date()) {
+    return {
+        account,
+        generators: [...generators],
+        others: [...others],
+        updatedAt: now.toISOString(),
+    };
+}
+export function writeStateFile(file, state) {
+    writeFileAtomic(file, JSON.stringify(state, null, 2) + '\n', 0o644);
+}
+/** The state file as last written, or null when missing or unreadable. Never throws. */
+export function readStateFile(file) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
+        if (!parsed || typeof parsed !== 'object' || !parsed.account || typeof parsed.account !== 'object') {
+            return null;
+        }
+        return {
+            account: parsed.account,
+            generators: Array.isArray(parsed.generators) ? parsed.generators : [],
+            others: Array.isArray(parsed.others) ? parsed.others : [],
+            updatedAt: typeof parsed.updatedAt === 'string' ? parsed.updatedAt : '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA2B7C,MAAM,UAAU,mBAAmB,CAAC,KAAqB,EAAE,cAA8B;IACvF,OAAO;QACL,GAAG,KAAK;QACR,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;QAC9D,cAAc,EAAE,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;KACjI,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAwB,EACxB,UAAuC,EACvC,MAA6B,EAC7B,MAAY,IAAI,IAAI,EAAE;IAEtB,OAAO;QACL,OAAO;QACP,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC;QAC3B,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;QACnB,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAgB;IAC3D,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC;AACtE,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAuB,CAAC;QAC/E,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACnG,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;YACrE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACzD,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;SACxE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,98 @@
+/** Raw shapes from https://app.mobilelinkgen.com/api/v5, as observed September 15, 2026. */
+export declare const DEVICE_TYPE: {
+    readonly GENERATOR: 0;
+    readonly UNKNOWN: 1;
+    readonly PROPANE_MONITOR: 2;
+    readonly LINKED_ECOBEE: 7;
+};
+export declare const DEVICE_TYPE_LABEL: Record<number, string>;
+/** apparatusStatus enum. */
+export declare const STATUS: {
+    readonly UNKNOWN0: 0;
+    readonly READY: 1;
+    readonly RUNNING: 2;
+    readonly EXERCISING: 3;
+    readonly WARNING: 4;
+    readonly STOPPED: 5;
+    readonly COMM_ISSUE: 6;
+    readonly UNKNOWN: 7;
+};
+export declare const STATUS_LABEL: Record<number, string>;
+/**
+ * Numeric property.type values on /Apparatus/details. Stable across Generac's
+ * display-name changes, so key on these rather than on property.name.
+ */
+export declare const PROP: {
+    readonly HOURS_OF_PROTECTION: 32;
+    readonly BATTERY_VOLTAGE: 70;
+    readonly ENGINE_HOURS: 71;
+    readonly FUEL_TYPE: 88;
+    readonly EXERCISE_MINUTES: 95;
+};
+export interface RawProperty {
+    name: string;
+    value: string | number | null;
+    type: number;
+}
+/** `alert.eventType` of the exercise-complete event (SPEC section 6). Observed once; see section 16 for the open item. */
+export declare const EXERCISE_COMPLETE_EVENT = 42;
+/** The `alert` object on /Apparatus/details: the most recent event on the unit. */
+export interface RawAlert {
+    eCode?: number | null;
+    eventType?: number | null;
+    timestamp?: string | null;
+    type?: number | null;
+}
+export interface RawWeather {
+    temperature?: {
+        value: number;
+        unit: string;
+        unitType?: number;
+    };
+    iconCode?: number;
+}
+export interface RawApparatus {
+    apparatusId: number;
+    type: number;
+    name: string;
+    serialNumber: string | null;
+    modelNumber: string | null;
+    apparatusStatus: number;
+    isConnected: boolean;
+    showWarning: boolean;
+    properties?: RawProperty[];
+    weather?: RawWeather;
+    [k: string]: unknown;
+}
+export interface RawApparatusDetail {
+    apparatusId: number;
+    name: string;
+    serialNumber: string | null;
+    apparatusStatus: number;
+    statusLabel?: string | null;
+    statusText?: string | null;
+    isConnected: boolean;
+    isConnecting?: boolean;
+    showWarning: boolean;
+    hasMaintenanceAlert?: boolean;
+    serviceModeEnabled?: boolean;
+    lastSeen?: string | null;
+    deviceType?: string | null;
+    networkType?: string | null;
+    weather?: RawWeather;
+    properties?: RawProperty[];
+    tuProperties?: RawProperty[];
+    productInfo?: RawProperty[];
+    alarms?: unknown[];
+    warnings?: unknown[];
+    maintenance?: unknown[];
+    currentAlarm?: string | null;
+    alert?: RawAlert | null;
+    [k: string]: unknown;
+}
+export interface StoredCredentials {
+    email: string;
+    refresh_token: string;
+    dpop_private_key_pem: string;
+    created_at: string;
+}

package/dist/types.js

@@ -0,0 +1,48 @@
+/** Raw shapes from https://app.mobilelinkgen.com/api/v5, as observed September 15, 2026. */
+export const DEVICE_TYPE = {
+    GENERATOR: 0,
+    UNKNOWN: 1,
+    PROPANE_MONITOR: 2,
+    LINKED_ECOBEE: 7,
+};
+export const DEVICE_TYPE_LABEL = {
+    0: 'generator',
+    1: 'unknown device',
+    2: 'propane tank monitor',
+    7: 'linked ecobee thermostat',
+};
+/** apparatusStatus enum. */
+export const STATUS = {
+    UNKNOWN0: 0,
+    READY: 1,
+    RUNNING: 2,
+    EXERCISING: 3,
+    WARNING: 4,
+    STOPPED: 5,
+    COMM_ISSUE: 6,
+    UNKNOWN: 7,
+};
+export const STATUS_LABEL = {
+    0: 'Unknown',
+    1: 'Ready',
+    2: 'Running',
+    3: 'Exercising',
+    4: 'Warning',
+    5: 'Stopped',
+    6: 'Communication Issue',
+    7: 'Unknown',
+};
+/**
+ * Numeric property.type values on /Apparatus/details. Stable across Generac's
+ * display-name changes, so key on these rather than on property.name.
+ */
+export const PROP = {
+    HOURS_OF_PROTECTION: 32,
+    BATTERY_VOLTAGE: 70,
+    ENGINE_HOURS: 71,
+    FUEL_TYPE: 88,
+    EXERCISE_MINUTES: 95,
+};
+/** `alert.eventType` of the exercise-complete event (SPEC section 6). Observed once; see section 16 for the open item. */
+export const EXERCISE_COMPLETE_EVENT = 42;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAE5F,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC;IACV,eAAe,EAAE,CAAC;IAClB,aAAa,EAAE,CAAC;CACR,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,gBAAgB;IACnB,CAAC,EAAE,sBAAsB;IACzB,CAAC,EAAE,0BAA0B;CAC9B,CAAC;AAEF,4BAA4B;AAC5B,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,CAAC;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,YAAY;IACf,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,SAAS;CACb,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,mBAAmB,EAAE,EAAE;IACvB,eAAe,EAAE,EAAE;IACnB,YAAY,EAAE,EAAE;IAChB,SAAS,EAAE,EAAE;IACb,gBAAgB,EAAE,EAAE;CACZ,CAAC;AAQX,0HAA0H;AAC1H,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC"}

package/dist/ui/server.d.ts

@@ -0,0 +1,96 @@
+import { HomebridgePluginUiServer } from '@homebridge/plugin-ui-utils';
+import { type LoginOptions, type LoginResult, type MfaType } from '../auth.js';
+import { type AccountSnapshot, type GeneratorSnapshot } from '../state.js';
+/** A pending Connect expires this long after Sign in (SPEC section 10). */
+export declare const PENDING_LOGIN_TTL_MS: number;
+/** Three rejected codes end the sign-in (SPEC section 4.1). */
+export declare const MAX_CODE_ATTEMPTS = 3;
+export type LoginFn = (email: string, password: string, opts: LoginOptions) => Promise<LoginResult>;
+export type StartError = 'wrong_password' | 'unknown_email' | 'unsupported_factor' | 'network';
+export type CodeError = 'wrong_code' | 'too_many' | 'expired';
+export type StartResponse = {
+    step: 'code';
+    method: MfaType;
+} | {
+    step: 'done';
+} | {
+    error: StartError;
+};
+export type CodeResponse = {
+    step: 'done';
+} | {
+    error: CodeError;
+};
+export interface StatusAccount extends Omit<AccountSnapshot, 'state'> {
+    state: AccountSnapshot['state'] | 'checking';
+}
+export interface StatusResponse {
+    account: StatusAccount;
+    generators: GeneratorSnapshot[];
+    others: Array<{
+        type: number;
+        name: string;
+    }>;
+    /** The installed package version, for the page footer. */
+    version: string;
+}
+export interface UiServerOptions {
+    storagePath: string;
+    /** config.json, read only for `credentialsPath` (SPEC section 4.4). */
+    configPath?: string;
+    login?: LoginFn;
+    now?: () => number;
+    version?: string;
+}
+type Handler = (payload: unknown) => Promise<unknown>;
+/** Maps a failed login to the page's error codes (SPEC section 10). */
+export declare function mapError(err: unknown, phase: 'start' | 'code'): StartResponse | CodeResponse;
+export declare class GeneracUiHandlers {
+    private readonly opts;
+    private readonly login;
+    private readonly now;
+    private readonly version;
+    private pending;
+    constructor(opts: UiServerOptions);
+    /** The request paths of SPEC section 10 and their handlers, for HomebridgePluginUiServer.onRequest. */
+    routes(): Record<string, Handler>;
+    status(): Promise<StatusResponse>;
+    /** True when the state file's account entry was written after these credentials were created. */
+    private stateNewerThan;
+    connectStart(payload: unknown): Promise<StartResponse>;
+    connectCode(payload: unknown): Promise<CodeResponse>;
+    connectCancel(): Promise<{
+        ok: true;
+    }>;
+    /** Whether a Connect is in progress (for tests). */
+    get hasPending(): boolean;
+    private settle;
+    /** The login ended (success or failure): forget it. */
+    private finish;
+    /** Cancel, replace or expire: the login is abandoned, its result (if it ever arrives) ignored, its prompt rejected. */
+    private discardPending;
+    private expire;
+    private writeCredentials;
+    disconnect(): Promise<{
+        ok: true;
+    }>;
+    /**
+     * The Reset dialog (SPEC section 11.3 E): sign out, forget the saved state, and leave a marker so the platform
+     * removes every cached accessory on its next start. The page resets the platform block itself.
+     */
+    reset(): Promise<{
+        ok: true;
+    }>;
+    private deleteCredentials;
+    /** Clears the account section of state.json, keeping the last generator states for the page. */
+    private clearAccountState;
+    private findCredentials;
+    /** `credentialsPath` from the platform block in config.json, when set. */
+    private configuredCredentialsPath;
+}
+/** The process the Homebridge UI starts (homebridge-ui/server.js). */
+export declare class GeneracUiServer extends HomebridgePluginUiServer {
+    constructor();
+}
+export declare function startUiServer(): GeneracUiServer;
+export {};