homebridge-generac 0.1.0-beta.1

package/dist/ui/server.js

@@ -0,0 +1,328 @@
+/**
+ * The settings page's server side (SPEC section 10). Started by the Homebridge UI as a child process through
+ * homebridge-ui/server.js; the platform never loads this module. It answers /status from credentials.json and
+ * the platform's state.json, runs the Connect flow (the only time the UI process talks to Generac), writes
+ * credentials.json with the platform's atomic writer, and deletes it on Disconnect.
+ *
+ * The password and the MFA code pass through `connectStart` and `connectCode` once each and are never logged or
+ * stored. The pending login is a single in-memory record; a second Connect replaces it.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { HomebridgePluginUiServer } from '@homebridge/plugin-ui-utils';
+import { readCredentials, writeCredentials } from '../api.js';
+import { AuthError, login as realLogin } from '../auth.js';
+import { credentialCandidates, dataDir, PLATFORM_NAME, pluginVersion, primaryCredentialsPath, RESET_MARKER, statePath } from '../settings.js';
+import { buildStateFile, readStateFile, writeStateFile } from '../state.js';
+/** A pending Connect expires this long after Sign in (SPEC section 10). */
+export const PENDING_LOGIN_TTL_MS = 5 * 60 * 1000;
+/** Three rejected codes end the sign-in (SPEC section 4.1). */
+export const MAX_CODE_ATTEMPTS = 3;
+/** A promise with its settlers, settled at most once. */
+class Deferred {
+    promise;
+    settle;
+    done = false;
+    constructor() {
+        this.promise = new Promise((resolve) => {
+            this.settle = resolve;
+        });
+    }
+    resolve(value) {
+        if (!this.done) {
+            this.done = true;
+            this.settle(value);
+        }
+    }
+}
+class CancelledError extends Error {
+    constructor(reason) {
+        super(`sign-in ${reason}`);
+        this.name = 'CancelledError';
+    }
+}
+/** Maps a failed login to the page's error codes (SPEC section 10). */
+export function mapError(err, phase) {
+    if (phase === 'code') {
+        if (err instanceof AuthError && /three rejected codes/.test(err.message)) {
+            return { error: 'too_many' };
+        }
+        return { error: 'expired' };
+    }
+    if (err instanceof AuthError) {
+        switch (err.step) {
+            case 'password':
+                return { error: 'wrong_password' };
+            case 'identifier':
+                return { error: 'unknown_email' };
+            case 'mfa':
+                return { error: 'unsupported_factor' };
+        }
+    }
+    return { error: 'network' };
+}
+function text(payload, key) {
+    const value = payload !== null && typeof payload === 'object' ? payload[key] : undefined;
+    return typeof value === 'string' ? value.trim() : '';
+}
+export class GeneracUiHandlers {
+    opts;
+    login;
+    now;
+    version;
+    pending = null;
+    constructor(opts) {
+        this.opts = opts;
+        this.login = opts.login ?? realLogin;
+        this.now = opts.now ?? Date.now;
+        this.version = opts.version ?? pluginVersion();
+    }
+    /** The request paths of SPEC section 10 and their handlers, for HomebridgePluginUiServer.onRequest. */
+    routes() {
+        return {
+            '/status': () => this.status(),
+            '/connect/start': (payload) => this.connectStart(payload),
+            '/connect/code': (payload) => this.connectCode(payload),
+            '/connect/cancel': () => this.connectCancel(),
+            '/disconnect': () => this.disconnect(),
+            '/reset': () => this.reset(),
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // /status
+    // ---------------------------------------------------------------------------
+    async status() {
+        const creds = this.findCredentials();
+        const state = readStateFile(statePath(this.opts.storagePath));
+        let account;
+        if (!creds) {
+            account = { state: 'not_connected' };
+        }
+        else if (this.stateNewerThan(state, creds.creds)) {
+            account = { state: state.account.state, email: creds.creds.email, lastChecked: state.account.lastChecked };
+        }
+        else {
+            // Credentials exist but the platform has not polled with them yet (SPEC section 10).
+            account = { state: 'checking', email: creds.creds.email };
+        }
+        return {
+            account,
+            generators: state?.generators ?? [],
+            others: (state?.others ?? []).map((o) => ({ type: o.type, name: o.name })),
+            version: this.version,
+        };
+    }
+    /** True when the state file's account entry was written after these credentials were created. */
+    stateNewerThan(state, creds) {
+        if (!state || state.account.state === 'not_connected') {
+            return false;
+        }
+        const updated = Date.parse(state.updatedAt);
+        const created = Date.parse(creds.created_at);
+        if (Number.isNaN(updated)) {
+            return false;
+        }
+        return Number.isNaN(created) || updated > created;
+    }
+    // ---------------------------------------------------------------------------
+    // Connect flow (SPEC section 10)
+    // ---------------------------------------------------------------------------
+    async connectStart(payload) {
+        const email = text(payload, 'email');
+        const password = text(payload, 'password');
+        if (!email || !password) {
+            return { error: 'network' };
+        }
+        this.discardPending('replaced');
+        const pending = {
+            email, startedAt: this.now(), phase: 'start', waiter: new Deferred(), prompt: null, attempts: 0, cancelled: false, expiry: null,
+        };
+        this.pending = pending;
+        pending.expiry = setTimeout(() => this.expire(pending), PENDING_LOGIN_TTL_MS);
+        pending.expiry.unref();
+        const mfaPrompt = (type, attempt) => new Promise((resolve, reject) => {
+            if (pending.cancelled) {
+                reject(new CancelledError('cancelled'));
+                return;
+            }
+            pending.prompt = { type, resolve, reject };
+            // A second or third prompt means Auth0 rejected the previous code.
+            this.settle(pending, attempt > 1 ? { error: 'wrong_code' } : { step: 'code', method: type });
+        });
+        // The password lives in this call's frames only; nothing here keeps a reference to it.
+        this.login(email, password, { mfaPrompt }).then((result) => {
+            if (pending.cancelled) {
+                return;
+            }
+            this.writeCredentials(email, result);
+            this.finish(pending);
+            this.settle(pending, { step: 'done' });
+        }, (err) => {
+            if (pending.cancelled) {
+                return;
+            }
+            this.finish(pending);
+            this.settle(pending, mapError(err, pending.phase));
+        });
+        return pending.waiter.promise;
+    }
+    async connectCode(payload) {
+        const code = text(payload, 'code');
+        const pending = this.pending;
+        if (!pending || !pending.prompt || !code) {
+            return { error: 'expired' };
+        }
+        if (this.now() - pending.startedAt >= PENDING_LOGIN_TTL_MS) {
+            this.expire(pending);
+            return { error: 'expired' };
+        }
+        if (pending.attempts >= MAX_CODE_ATTEMPTS) {
+            return { error: 'too_many' };
+        }
+        pending.attempts++;
+        pending.phase = 'code';
+        pending.waiter = new Deferred();
+        const prompt = pending.prompt;
+        pending.prompt = null;
+        prompt.resolve(code);
+        return pending.waiter.promise;
+    }
+    async connectCancel() {
+        this.discardPending('cancelled');
+        return { ok: true };
+    }
+    /** Whether a Connect is in progress (for tests). */
+    get hasPending() {
+        return this.pending !== null;
+    }
+    settle(pending, response) {
+        const waiter = pending.waiter;
+        pending.waiter = null;
+        waiter?.resolve(response);
+    }
+    /** The login ended (success or failure): forget it. */
+    finish(pending) {
+        if (pending.expiry) {
+            clearTimeout(pending.expiry);
+            pending.expiry = null;
+        }
+        if (this.pending === pending) {
+            this.pending = null;
+        }
+    }
+    /** Cancel, replace or expire: the login is abandoned, its result (if it ever arrives) ignored, its prompt rejected. */
+    discardPending(reason) {
+        const pending = this.pending;
+        if (!pending) {
+            return;
+        }
+        pending.cancelled = true;
+        this.finish(pending);
+        const prompt = pending.prompt;
+        pending.prompt = null;
+        prompt?.reject(new CancelledError(reason));
+        // A request still waiting (Sign in in flight, or a code in flight) is answered so the page never hangs.
+        this.settle(pending, pending.phase === 'start' ? { error: 'network' } : { error: 'expired' });
+    }
+    expire(pending) {
+        if (this.pending === pending) {
+            this.discardPending('expired');
+        }
+    }
+    writeCredentials(email, result) {
+        writeCredentials(primaryCredentialsPath(this.opts.storagePath), {
+            email,
+            refresh_token: result.refreshToken,
+            dpop_private_key_pem: result.key.toPem(),
+            created_at: new Date(this.now()).toISOString(),
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // /disconnect and /reset
+    // ---------------------------------------------------------------------------
+    async disconnect() {
+        this.discardPending('cancelled');
+        this.deleteCredentials();
+        this.clearAccountState();
+        return { 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.
+     */
+    async reset() {
+        this.discardPending('cancelled');
+        this.deleteCredentials();
+        fs.rmSync(statePath(this.opts.storagePath), { force: true });
+        fs.mkdirSync(dataDir(this.opts.storagePath), { recursive: true, mode: 0o700 });
+        fs.writeFileSync(path.join(dataDir(this.opts.storagePath), RESET_MARKER), new Date(this.now()).toISOString() + '\n', { mode: 0o600 });
+        return { ok: true };
+    }
+    deleteCredentials() {
+        const files = new Set([primaryCredentialsPath(this.opts.storagePath)]);
+        const found = this.findCredentials();
+        if (found) {
+            files.add(found.file);
+        }
+        for (const file of files) {
+            fs.rmSync(file, { force: true });
+        }
+    }
+    /** Clears the account section of state.json, keeping the last generator states for the page. */
+    clearAccountState() {
+        const file = statePath(this.opts.storagePath);
+        const state = readStateFile(file);
+        writeStateFile(file, buildStateFile({ state: 'not_connected' }, state?.generators ?? [], state?.others ?? [], new Date(this.now())));
+    }
+    // ---------------------------------------------------------------------------
+    // Credentials on disk (SPEC section 4.4)
+    // ---------------------------------------------------------------------------
+    findCredentials() {
+        for (const file of credentialCandidates(this.opts.storagePath, this.configuredCredentialsPath())) {
+            try {
+                const creds = readCredentials(file);
+                if (creds) {
+                    return { file, creds };
+                }
+            }
+            catch {
+                // Unreadable or malformed: the platform warns about it; the page shows not connected.
+            }
+        }
+        return null;
+    }
+    /** `credentialsPath` from the platform block in config.json, when set. */
+    configuredCredentialsPath() {
+        if (!this.opts.configPath) {
+            return undefined;
+        }
+        try {
+            const config = JSON.parse(fs.readFileSync(this.opts.configPath, 'utf8'));
+            const block = config.platforms?.find((p) => p && p.platform === PLATFORM_NAME);
+            const value = block?.credentialsPath;
+            return typeof value === 'string' && value.trim() ? value : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+/** The process the Homebridge UI starts (homebridge-ui/server.js). */
+export class GeneracUiServer extends HomebridgePluginUiServer {
+    constructor() {
+        super();
+        const storagePath = this.homebridgeStoragePath;
+        if (!storagePath) {
+            throw new Error('The Homebridge storage path is not available to the Generac settings UI server');
+        }
+        const handlers = new GeneracUiHandlers({ storagePath, configPath: this.homebridgeConfigPath });
+        for (const [route, handler] of Object.entries(handlers.routes())) {
+            this.onRequest(route, handler);
+        }
+        this.ready();
+    }
+}
+export function startUiServer() {
+    return new GeneracUiServer();
+}
+//# sourceMappingURL=server.js.map

package/dist/ui/server.js.map

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

package/homebridge-ui/public/generac.css

@@ -0,0 +1,255 @@
+/* What this page adds to the shell: the affiliation line under the intro (SPEC section 11.1, item 2a) and the account
+   and generator cards (11.3 B to D). Every colour is a host variable with the host's light value as the fallback; the dark values are re-declared
+   in index.css under the host's dark marker. */
+
+.gn-body {
+  margin: 0 0 12px;
+}
+
+.gn-body:last-child {
+  margin-bottom: 0;
+}
+
+/* The email on the account card, monospace like every identifier. */
+.gn-row {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px 12px;
+  margin: 0 0 8px;
+}
+
+.gn-email {
+  font-family: var(--bs-font-monospace, SFMono-Regular, Menlo, Consolas, monospace);
+}
+
+.gn-meta {
+  color: var(--bs-secondary-color, currentColor);
+  font-size: 0.875em;
+  margin: 0 0 1rem;
+}
+
+/* The row of buttons under a card body: the primary button and its text Cancel. */
+.gn-actions {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px 12px;
+  margin: 0 0 16px;
+}
+
+/* Badges beyond the shell's status badge (SPEC section 11.2): the host's subtle success (Ready), info (Running,
+   Exercising), danger (Fault), secondary (Not responding) and warning (Maintenance due, Low) variables; an outline
+   for Checking. */
+.generac-ui .gn-badge {
+  border: 1px solid transparent;
+  white-space: nowrap;
+}
+
+.generac-ui .gn-badge-ready {
+  color: var(--bs-success-text-emphasis, #0a3622);
+  background-color: var(--bs-success-bg-subtle, #d1e7dd);
+  border-color: var(--bs-success-border-subtle, #a3cfbb);
+}
+
+.generac-ui .gn-badge-running,
+.generac-ui .gn-badge-exercising {
+  color: var(--bs-info-text-emphasis, #055160);
+  background-color: var(--bs-info-bg-subtle, #cff4fc);
+  border-color: var(--bs-info-border-subtle, #9eeaf9);
+}
+
+.generac-ui .gn-badge-exercising {
+  background-color: transparent;
+}
+
+.generac-ui .gn-badge-fault {
+  color: var(--bs-danger-text-emphasis, #58151c);
+  background-color: var(--bs-danger-bg-subtle, #f8d7da);
+  border-color: var(--bs-danger-border-subtle, #f1aeb5);
+}
+
+.generac-ui .gn-badge-muted,
+.generac-ui .gn-badge-outline {
+  color: var(--bs-secondary-color, currentColor);
+  background-color: transparent;
+  border-color: var(--bs-secondary, #6c757d);
+}
+
+.generac-ui .gn-badge-warn {
+  color: var(--bs-warning-text-emphasis, #664d03);
+  background-color: var(--bs-warning-bg-subtle, #fff3cd);
+  border-color: #ffecb5;
+}
+
+/* The generator card title: the name in bold, then the model and the serial number on their own lines. */
+.gn-title-block {
+  display: inline-block;
+  min-width: 0;
+}
+
+.gn-model {
+  display: block;
+  font-weight: 400;
+  font-size: 0.875em;
+  line-height: 1.4;
+}
+
+.gn-serial {
+  display: block;
+  font-weight: 300;
+  font-size: 0.875em;
+  line-height: 1.4;
+  color: var(--bs-secondary-color, currentColor);
+  font-family: var(--bs-font-monospace, SFMono-Regular, Menlo, Consolas, monospace);
+}
+
+/* The status row: the badges, then the fault reasons one per line (on a phone) or dot-separated, or the note. */
+.gn-status {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 6px 12px;
+  margin: 0 0 12px;
+}
+
+.gn-reasons {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px 12px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.gn-reasons li {
+  color: var(--bs-secondary-color, currentColor);
+}
+
+.gn-reasons li + li::before {
+  content: "\00B7";
+  margin-right: 12px;
+}
+
+.gn-note {
+  color: var(--bs-secondary-color, currentColor);
+}
+
+/* The detail rows: label and value in two columns, one column on a phone. */
+.gn-kv {
+  display: grid;
+  grid-template-columns: minmax(0, max-content) minmax(0, 1fr);
+  column-gap: 16px;
+  row-gap: 6px;
+  margin: 0 0 16px;
+  padding-top: 12px;
+  border-top: 1px solid var(--bs-border-color, rgba(128, 128, 128, 0.35));
+}
+
+.gn-kv dt {
+  color: var(--bs-secondary-color, currentColor);
+  font-weight: 400;
+  margin: 0;
+}
+
+.gn-kv dd {
+  margin: 0;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 4px 8px;
+}
+
+.gn-kv .gn-help {
+  font-size: 0.875em;
+  font-weight: 300;
+  color: var(--bs-secondary-color, currentColor);
+}
+
+@media (max-width: 599.98px) {
+  .gn-kv {
+    grid-template-columns: minmax(0, 1fr);
+    row-gap: 2px;
+  }
+
+  .gn-kv dd {
+    margin-bottom: 8px;
+  }
+}
+
+/* Rename in the footer, editing in place: the Name field with Save name and Cancel beside it. */
+.gn-rename {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+  flex: 1 1 auto;
+  justify-content: flex-end;
+}
+
+.gn-rename-editor {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: flex-end;
+  gap: 8px 12px;
+  width: 100%;
+}
+
+.gn-rename-editor > .mb-3 {
+  flex: 1 1 14rem;
+  margin-bottom: 0 !important;
+}
+
+.gn-rename-actions {
+  display: inline-flex;
+  align-items: center;
+  gap: 12px;
+  padding-bottom: 4px;
+}
+
+/* The empty line and the "Also on your account" lines under the cards. */
+.gn-empty,
+.gn-also {
+  color: var(--bs-secondary-color, currentColor);
+  margin: 0 0 8px;
+}
+
+.gn-reset {
+  margin-top: 0.25rem;
+  margin-bottom: 1rem;
+}
+
+/* The Reset dialog, in the page flow directly below the Reset link (SPEC section 11.2): a bordered panel in the
+   card's colours, never a fixed overlay. */
+.generac-ui .ns-inline-dialog {
+  margin-top: 0.75rem;
+  max-width: 28rem;
+  border: 1px solid var(--bs-border-color, rgba(128, 128, 128, 0.35));
+  border-radius: 0.5rem;
+  background: var(--bs-body-bg, #fff);
+  color: var(--bs-body-color, inherit);
+}
+
+.generac-ui .ns-inline-dialog-title {
+  padding: 0.75rem 1rem;
+  border-bottom: 1px solid var(--bs-border-color, rgba(128, 128, 128, 0.35));
+}
+
+.generac-ui .ns-inline-dialog-body {
+  padding: 1rem;
+}
+
+.generac-ui .ns-inline-dialog-actions {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px 12px;
+  padding: 0.75rem 1rem;
+  border-top: 1px solid var(--bs-border-color, rgba(128, 128, 128, 0.35));
+}
+
+/* The affiliation line: muted, directly under the intro paragraphs, never in the footer. */
+.gn-affiliation {
+  margin: 0 0 0.5rem;
+  color: var(--bs-secondary-color, currentColor);
+}