homebridge-generac 0.1.0-beta.1

package/dist/accessory.js

@@ -0,0 +1,191 @@
+import { batteryPercent } from './model.js';
+/**
+ * One Generac generator as a HomeKit accessory.
+ *
+ * Deliberately not an Outlet or Switch: HomeKit would then read "off" while the
+ * unit sits healthy in Ready, and a fault would have nowhere to go but a thrown
+ * error (which the Home app renders as "No Response"). Contact sensors give
+ * three independently automatable, notifiable booleans, and StatusFault /
+ * StatusActive carry the health signals HomeKit already understands.
+ *
+ *   Running          contact OPEN while the engine is running
+ *   Fault            contact OPEN on warning / alarm / stopped (see FaultOptions)
+ *   Maintenance Due  contact OPEN when Generac flags service
+ *   Exercising       contact OPEN while an exercise is detected, live or retroactively (optional, SPEC section 7)
+ *   Battery          starting-battery voltage mapped to level + low-battery flag
+ */
+export class GeneratorAccessory {
+    platform;
+    accessory;
+    running;
+    fault;
+    maintenance;
+    /** Present only while `exerciseSensor` is on; the platform drives it through `setExercising`. */
+    exercising;
+    battery;
+    state = null;
+    exerciseOpen = false;
+    displayName;
+    constructor(platform, accessory, initial, displayName) {
+        this.platform = platform;
+        this.accessory = accessory;
+        const { Service, Characteristic } = platform.api.hap;
+        this.displayName = accessory.displayName;
+        accessory
+            .getService(Service.AccessoryInformation)
+            .setCharacteristic(Characteristic.Manufacturer, 'Generac')
+            .setCharacteristic(Characteristic.Model, initial.model)
+            .setCharacteristic(Characteristic.SerialNumber, initial.serial)
+            .setCharacteristic(Characteristic.FirmwareRevision, platform.firmware);
+        this.running = this.contact('Running', 'running');
+        this.fault = this.contact('Fault', 'fault');
+        this.maintenance = this.contact('Maintenance Due', 'maintenance');
+        const cachedExercising = accessory.getServiceById(Service.ContactSensor, 'exercising');
+        if (platform.config.exerciseSensor) {
+            this.exercising = this.contact('Exercising', 'exercising');
+            this.exercising.getCharacteristic(Characteristic.ContactSensorState).onGet(() => this.contactState(this.exerciseOpen));
+        }
+        else {
+            this.exercising = null;
+            if (cachedExercising) {
+                // The setting was turned off: the cached service goes, like the Attention needed sensor does.
+                accessory.removeService(cachedExercising);
+            }
+        }
+        this.battery =
+            accessory.getService(Service.Battery) ?? accessory.addService(Service.Battery, `${this.displayName} Battery`);
+        this.battery.setCharacteristic(Characteristic.ChargingState, Characteristic.ChargingState.NOT_CHARGEABLE);
+        this.battery.getCharacteristic(Characteristic.BatteryLevel).onGet(() => batteryPercent(this.state?.batteryVoltage ?? null));
+        this.battery.getCharacteristic(Characteristic.StatusLowBattery).onGet(() => this.lowBattery());
+        // Cached-state getters. Never throw from here: a failed poll is reported
+        // through StatusActive/StatusFault, not by breaking the accessory.
+        this.running.getCharacteristic(Characteristic.ContactSensorState).onGet(() => this.contactState(this.state?.running));
+        this.fault.getCharacteristic(Characteristic.ContactSensorState).onGet(() => this.contactState(this.state?.fault));
+        this.maintenance.getCharacteristic(Characteristic.ContactSensorState).onGet(() => this.contactState(this.state?.maintenanceDue));
+        // A cached accessory may carry a display name from before an override was
+        // added or changed. Bring it up to date in place.
+        this.setDisplayName(displayName);
+        this.update(initial);
+    }
+    contact(label, subtype) {
+        const { Service, Characteristic } = this.platform.api.hap;
+        const name = `${this.displayName} ${label}`;
+        const svc = this.accessory.getServiceById(Service.ContactSensor, subtype) ??
+            this.accessory.addService(Service.ContactSensor, name, subtype);
+        svc.setCharacteristic(Characteristic.Name, name);
+        if (!svc.testCharacteristic(Characteristic.ConfiguredName)) {
+            svc.addOptionalCharacteristic(Characteristic.ConfiguredName);
+        }
+        if (!svc.getCharacteristic(Characteristic.ConfiguredName).value) {
+            svc.setCharacteristic(Characteristic.ConfiguredName, name);
+        }
+        svc.addOptionalCharacteristic(Characteristic.StatusActive);
+        svc.addOptionalCharacteristic(Characteristic.StatusFault);
+        return svc;
+    }
+    /**
+     * Apply a display name (the `generators[]` override or the Mobile Link name).
+     * Service names follow. ConfiguredName follows only while it still holds the
+     * name this plugin gave it, so a rename made in the Home app sticks.
+     * Returns true when anything changed, so the platform can persist the cache.
+     */
+    setDisplayName(name) {
+        if (name === this.displayName) {
+            return false;
+        }
+        const { Characteristic } = this.platform.api.hap;
+        const previous = this.displayName;
+        this.displayName = name;
+        this.accessory.displayName = name;
+        for (const [svc, label] of this.contacts()) {
+            const oldName = `${previous} ${label}`;
+            const newName = `${name} ${label}`;
+            svc.updateCharacteristic(Characteristic.Name, newName);
+            const configured = svc.getCharacteristic(Characteristic.ConfiguredName).value;
+            if (!configured || configured === oldName) {
+                svc.updateCharacteristic(Characteristic.ConfiguredName, newName);
+            }
+        }
+        this.battery.updateCharacteristic(Characteristic.Name, `${name} Battery`);
+        return true;
+    }
+    /** Every contact sensor with its label, the optional Exercising one included. */
+    contacts() {
+        const out = [
+            [this.running, 'Running'],
+            [this.fault, 'Fault'],
+            [this.maintenance, 'Maintenance Due'],
+        ];
+        if (this.exercising) {
+            out.push([this.exercising, 'Exercising']);
+        }
+        return out;
+    }
+    contactState(open) {
+        const { Characteristic } = this.platform.api.hap;
+        return open ? Characteristic.ContactSensorState.CONTACT_NOT_DETECTED : Characteristic.ContactSensorState.CONTACT_DETECTED;
+    }
+    lowBattery() {
+        const { Characteristic } = this.platform.api.hap;
+        const v = this.state?.batteryVoltage;
+        const low = v !== null && v !== undefined && v <= this.platform.config.batteryLowVoltage;
+        return low ? Characteristic.StatusLowBattery.BATTERY_LEVEL_LOW : Characteristic.StatusLowBattery.BATTERY_LEVEL_NORMAL;
+    }
+    /** Push a fresh state into HomeKit. Always updates; never gated on identity fields. */
+    update(next) {
+        const { Characteristic } = this.platform.api.hap;
+        const prev = this.state;
+        this.state = next;
+        const active = next.connected;
+        const faultFlag = next.fault ? Characteristic.StatusFault.GENERAL_FAULT : Characteristic.StatusFault.NO_FAULT;
+        for (const [svc, open] of [
+            [this.running, next.running],
+            [this.fault, next.fault],
+            [this.maintenance, next.maintenanceDue],
+        ]) {
+            svc.updateCharacteristic(Characteristic.ContactSensorState, this.contactState(open));
+        }
+        for (const [svc] of this.contacts()) {
+            svc.updateCharacteristic(Characteristic.StatusActive, active);
+            svc.updateCharacteristic(Characteristic.StatusFault, faultFlag);
+        }
+        this.battery.updateCharacteristic(Characteristic.BatteryLevel, batteryPercent(next.batteryVoltage));
+        this.battery.updateCharacteristic(Characteristic.StatusLowBattery, this.lowBattery());
+        if (!prev || prev.status !== next.status || prev.fault !== next.fault || prev.connected !== next.connected) {
+            const bits = [
+                `status=${next.statusLabel}`,
+                `connected=${next.connected}`,
+                next.batteryVoltage !== null ? `battery=${next.batteryVoltage}V` : null,
+                next.fault ? `fault=[${next.faultReasons.join('; ')}]` : null,
+                next.maintenanceDue ? 'maintenance due' : null,
+            ].filter(Boolean);
+            this.platform.log.info(`${this.displayName}: ${bits.join(' ')}`);
+        }
+    }
+    /** The last state pushed to HomeKit. */
+    get current() {
+        return this.state;
+    }
+    /** Opens or closes the Exercising sensor (SPEC section 7, service 6). A no-op without the sensor. */
+    setExercising(open) {
+        const { Characteristic } = this.platform.api.hap;
+        const changed = open !== this.exerciseOpen;
+        this.exerciseOpen = open;
+        this.exercising?.updateCharacteristic(Characteristic.ContactSensorState, this.contactState(open));
+        if (changed && this.exercising) {
+            this.platform.log.info(`${this.displayName}: Exercising sensor ${open ? 'open' : 'closed'}`);
+        }
+    }
+    /** Whether the Exercising sensor is open. */
+    get isExercising() {
+        return this.exerciseOpen;
+    }
+    /** Mark the accessory unreachable after repeated poll failures without changing its last state. */
+    markUnreachable() {
+        const { Characteristic } = this.platform.api.hap;
+        for (const [svc] of this.contacts()) {
+            svc.updateCharacteristic(Characteristic.StatusActive, false);
+        }
+    }
+}
+//# sourceMappingURL=accessory.js.map

package/dist/accessory.js.map

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

package/dist/api.d.ts

@@ -0,0 +1,43 @@
+import { DPoPKey, InvalidGrantError, type LoginOptions } from './auth.js';
+import type { RawApparatus, RawApparatusDetail, StoredCredentials } from './types.js';
+export declare function readCredentials(file: string): StoredCredentials | null;
+/** Atomic (temp file plus rename), mode 600. See SPEC section 4.4. */
+export declare function writeCredentials(file: string, creds: StoredCredentials): void;
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly endpoint: string;
+    constructor(message: string, status: number, endpoint: string);
+}
+export interface ClientOptions {
+    log?: LoginOptions['log'];
+    /** Refresh this many seconds before the access token actually expires. */
+    refreshSkewSeconds?: number;
+}
+/**
+ * Holds one access token and refreshes it only when needed. The original
+ * plugin re-logged-in on every poll; Generac has publicly complained about
+ * exactly that traffic, so this client is deliberately frugal.
+ */
+export declare class MobileLinkClient {
+    private readonly key;
+    private readonly refreshToken;
+    private readonly opts;
+    private accessToken;
+    private expiresAt;
+    private refreshing;
+    constructor(key: DPoPKey, refreshToken: string, opts?: ClientOptions);
+    static fromCredentials(creds: StoredCredentials, opts?: ClientOptions): MobileLinkClient;
+    private token;
+    /**
+     * NOTE: Bearer, not DPoP. The token is DPoP-bound (cnf.jkt) but Generac's
+     * resource server does not implement DPoP and returns 401 to the
+     * `Authorization: DPoP` scheme. Probed by the ha-generac maintainers on
+     * June 25, 2026. Do not "fix" this by sending a proof here.
+     */
+    private get;
+    listApparatus(): Promise<RawApparatus[]>;
+    apparatusDetails(id: number): Promise<RawApparatusDetail | null>;
+}
+export { InvalidGrantError };
+/** Exponential backoff with jitter, capped. Returns milliseconds to wait. */
+export declare function backoffMs(consecutiveFailures: number, baseMs: number, maxMs: number): number;

package/dist/api.js

@@ -0,0 +1,124 @@
+import fs from 'node:fs';
+import { DPoPKey, InvalidGrantError, refreshAccessToken, USER_AGENT_API } from './auth.js';
+import { writeFileAtomic } from './files.js';
+const API_BASE = 'https://app.mobilelinkgen.com/api/v5';
+// ---------------------------------------------------------------------------
+// Credentials on disk
+// ---------------------------------------------------------------------------
+export function readCredentials(file) {
+    if (!fs.existsSync(file)) {
+        return null;
+    }
+    const c = JSON.parse(fs.readFileSync(file, 'utf8'));
+    if (!c.refresh_token || !c.dpop_private_key_pem) {
+        return null;
+    }
+    return c;
+}
+/** Atomic (temp file plus rename), mode 600. See SPEC section 4.4. */
+export function writeCredentials(file, creds) {
+    writeFileAtomic(file, JSON.stringify(creds, null, 2) + '\n', 0o600);
+}
+// ---------------------------------------------------------------------------
+// HTTP client
+// ---------------------------------------------------------------------------
+export class ApiError extends Error {
+    status;
+    endpoint;
+    constructor(message, status, endpoint) {
+        super(message);
+        this.status = status;
+        this.endpoint = endpoint;
+        this.name = 'ApiError';
+    }
+}
+/**
+ * Holds one access token and refreshes it only when needed. The original
+ * plugin re-logged-in on every poll; Generac has publicly complained about
+ * exactly that traffic, so this client is deliberately frugal.
+ */
+export class MobileLinkClient {
+    key;
+    refreshToken;
+    opts;
+    accessToken = null;
+    expiresAt = 0;
+    refreshing = null;
+    constructor(key, refreshToken, opts = {}) {
+        this.key = key;
+        this.refreshToken = refreshToken;
+        this.opts = opts;
+    }
+    static fromCredentials(creds, opts) {
+        return new MobileLinkClient(DPoPKey.fromPem(creds.dpop_private_key_pem), creds.refresh_token, opts);
+    }
+    async token() {
+        const skew = (this.opts.refreshSkewSeconds ?? 120) * 1000;
+        if (this.accessToken && Date.now() < this.expiresAt - skew) {
+            return this.accessToken;
+        }
+        if (!this.refreshing) {
+            this.refreshing = refreshAccessToken(this.key, this.refreshToken, this.opts.log)
+                .then((t) => {
+                this.accessToken = t.access_token;
+                this.expiresAt = Date.now() + t.expires_in * 1000;
+                return t.access_token;
+            })
+                .finally(() => {
+                this.refreshing = null;
+            });
+        }
+        return this.refreshing;
+    }
+    /**
+     * NOTE: Bearer, not DPoP. The token is DPoP-bound (cnf.jkt) but Generac's
+     * resource server does not implement DPoP and returns 401 to the
+     * `Authorization: DPoP` scheme. Probed by the ha-generac maintainers on
+     * June 25, 2026. Do not "fix" this by sending a proof here.
+     */
+    async get(endpoint) {
+        const token = await this.token();
+        const res = await fetch(`${API_BASE}${endpoint}`, {
+            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json', 'User-Agent': USER_AGENT_API },
+        });
+        if (res.status === 204) {
+            return null;
+        }
+        const text = await res.text();
+        if (res.status === 401) {
+            // Token was rejected mid-lifetime. Drop it so the next call refreshes.
+            this.accessToken = null;
+            throw new ApiError(`GET ${endpoint}: 401 unauthorized`, 401, endpoint);
+        }
+        if (res.status !== 200) {
+            throw new ApiError(`GET ${endpoint}: HTTP ${res.status} ${text.slice(0, 200)}`, res.status, endpoint);
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new ApiError(`GET ${endpoint}: non-JSON body`, res.status, endpoint);
+        }
+    }
+    async listApparatus() {
+        const list = await this.get('/Apparatus/list');
+        if (!Array.isArray(list)) {
+            throw new ApiError('/Apparatus/list: expected an array', 200, '/Apparatus/list');
+        }
+        return list;
+    }
+    async apparatusDetails(id) {
+        return this.get(`/Apparatus/details/${id}`);
+    }
+}
+export { InvalidGrantError };
+// ---------------------------------------------------------------------------
+// Backoff
+// ---------------------------------------------------------------------------
+/** Exponential backoff with jitter, capped. Returns milliseconds to wait. */
+export function backoffMs(consecutiveFailures, baseMs, maxMs) {
+    const exp = Math.min(maxMs, baseMs * 2 ** Math.max(0, consecutiveFailures - 1));
+    const jitter = exp * (0.8 + Math.random() * 0.4);
+    return Math.round(Math.min(maxMs, jitter));
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/attention.d.ts

@@ -0,0 +1,18 @@
+import type { PlatformAccessory } from 'homebridge';
+import type { GeneracPlatform } from './platform.js';
+export declare const ATTENTION_NAME = "Generac Attention Needed";
+/**
+ * Optional platform-level OccupancySensor (SPEC section 7). Occupancy is
+ * detected while the plugin is in Reconnect needed, so a HomeKit automation or
+ * notification can tell the user to sign in again.
+ */
+export declare class AttentionAccessory {
+    private readonly platform;
+    readonly accessory: PlatformAccessory;
+    private readonly sensor;
+    private needed;
+    constructor(platform: GeneracPlatform, accessory: PlatformAccessory);
+    private value;
+    set(needed: boolean): void;
+    get isNeeded(): boolean;
+}

package/dist/attention.js

@@ -0,0 +1,40 @@
+export const ATTENTION_NAME = 'Generac Attention Needed';
+/**
+ * Optional platform-level OccupancySensor (SPEC section 7). Occupancy is
+ * detected while the plugin is in Reconnect needed, so a HomeKit automation or
+ * notification can tell the user to sign in again.
+ */
+export class AttentionAccessory {
+    platform;
+    accessory;
+    sensor;
+    needed = false;
+    constructor(platform, accessory) {
+        this.platform = platform;
+        this.accessory = accessory;
+        const { Service, Characteristic } = platform.api.hap;
+        accessory
+            .getService(Service.AccessoryInformation)
+            .setCharacteristic(Characteristic.Manufacturer, 'Generac for Homebridge')
+            .setCharacteristic(Characteristic.Model, 'Attention needed')
+            .setCharacteristic(Characteristic.SerialNumber, 'attention')
+            .setCharacteristic(Characteristic.FirmwareRevision, platform.firmware);
+        this.sensor = accessory.getService(Service.OccupancySensor) ?? accessory.addService(Service.OccupancySensor, ATTENTION_NAME);
+        this.sensor.setCharacteristic(Characteristic.Name, ATTENTION_NAME);
+        this.sensor.getCharacteristic(Characteristic.OccupancyDetected).onGet(() => this.value());
+        this.set(false);
+    }
+    value() {
+        const { Characteristic } = this.platform.api.hap;
+        return this.needed ? Characteristic.OccupancyDetected.OCCUPANCY_DETECTED : Characteristic.OccupancyDetected.OCCUPANCY_NOT_DETECTED;
+    }
+    set(needed) {
+        const { Characteristic } = this.platform.api.hap;
+        this.needed = needed;
+        this.sensor.updateCharacteristic(Characteristic.OccupancyDetected, this.value());
+    }
+    get isNeeded() {
+        return this.needed;
+    }
+}
+//# sourceMappingURL=attention.js.map

package/dist/attention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention.js","sourceRoot":"","sources":["../src/attention.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAEzD;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IAKV;IACR;IALM,MAAM,CAAU;IACzB,MAAM,GAAG,KAAK,CAAC;IAEvB,YACmB,QAAyB,EACjC,SAA4B;QADpB,aAAQ,GAAR,QAAQ,CAAiB;QACjC,cAAS,GAAT,SAAS,CAAmB;QAErC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QACrD,SAAS;aACN,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAE;aACzC,iBAAiB,CAAC,cAAc,CAAC,YAAY,EAAE,wBAAwB,CAAC;aACxE,iBAAiB,CAAC,cAAc,CAAC,KAAK,EAAE,kBAAkB,CAAC;aAC3D,iBAAiB,CAAC,cAAc,CAAC,YAAY,EAAE,WAAW,CAAC;aAC3D,iBAAiB,CAAC,cAAc,CAAC,gBAAgB,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEzE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;QAC7H,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1F,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IAEO,KAAK;QACX,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC,CAAC,cAAc,CAAC,iBAAiB,CAAC,sBAAsB,CAAC;IACrI,CAAC;IAED,GAAG,CAAC,MAAe;QACjB,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,cAAc,CAAC,iBAAiB,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/auth.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The Auth0 and DPoP login flow in this file is ported from binarydev/ha-generac
+ * (Auth0 flow by sslivins, MFA handling by pjordanandrsn, Apache-2.0; see NOTICE).
+ * It was validated end to end against a live Mobile Link account with SMS MFA
+ * on September 15, 2026.
+ */
+export declare const AUTH0_DOMAIN = "auth.ecobee.com";
+export declare const USER_AGENT_API = "mobilelink/86535 CFNetwork/3860.500.112 Darwin/25.4.0";
+export type MfaType = 'sms' | 'otp' | 'email';
+export interface TokenResponse {
+    access_token: string;
+    refresh_token?: string;
+    expires_in: number;
+    token_type: string;
+    scope?: string;
+}
+export interface LoginOptions {
+    /** Called when Auth0 presents a code-based MFA challenge. Return the code. */
+    mfaPrompt: (type: MfaType, attempt: number) => Promise<string>;
+    /** Optional step logger for diagnostics. Never receives secrets. */
+    log?: (step: string, message: string) => void;
+    /** Optional sink for the HTML of a failed step. */
+    onFailureBody?: (step: string, status: number, body: string) => void;
+}
+export interface LoginResult {
+    key: DPoPKey;
+    refreshToken: string;
+    tokens: TokenResponse;
+}
+export declare class AuthError extends Error {
+    readonly step: string;
+    constructor(message: string, step: string);
+}
+/** Refresh token has been revoked or expired server-side. Needs a new login. */
+export declare class InvalidGrantError extends AuthError {
+    constructor(message: string);
+}
+export declare class DPoPKey {
+    private readonly privateKey;
+    readonly jwk: {
+        crv: string;
+        kty: string;
+        x: string;
+        y: string;
+    };
+    readonly thumbprint: string;
+    private constructor();
+    static generate(): DPoPKey;
+    static fromPem(pem: string): DPoPKey;
+    toPem(): string;
+    signProof(htm: string, htu: string, nonce?: string | null): string;
+}
+export declare function extractAuth0ErrorCode(html: string): string | null;
+export declare function challengeType(pathname: string): MfaType | null;
+export declare function login(email: string, password: string, opts: LoginOptions): Promise<LoginResult>;
+export declare function refreshAccessToken(key: DPoPKey, refreshToken: string, log?: LoginOptions['log']): Promise<TokenResponse>;