homebridge-generac 0.1.0-beta.1 → 1.0.0

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to homebridge-generac are listed here. The format follows Ke
 
 ## Unreleased
 
+## 1.0.0 (September 26, 2026)
+
+First stable release, after a soak of the beta on a live install since September 16, 2026.
+
+### Added
+
+- Node 24 support. The plugin runs on Node 20, 22 and 24, and CI tests all three.
+- After Confirm, the Reset dialog is replaced in place by a done state that says to click Save and restart Homebridge, and the Reset link is hidden until the page reloads.
+
+### Fixed
+
+- The Reset dialog in the Homebridge UI dark theme: it now uses the host's card colours instead of a white panel.
+- The Reset confirmation accepts RESET in any case.
+
 ## 0.1.0-beta.1 (September 15, 2026)
 
 First beta of Generac for Homebridge, a ground-up successor to homebridge-mobilelink.

package/README.md

@@ -6,7 +6,7 @@ Do not claim it. Once the plugin is verified, replace this comment with the badg
 [![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
 -->
 
-[![npm version](https://img.shields.io/npm/v/homebridge-generac/beta)](https://www.npmjs.com/package/homebridge-generac)
+[![npm version](https://img.shields.io/npm/v/homebridge-generac)](https://www.npmjs.com/package/homebridge-generac)
 [![npm downloads](https://img.shields.io/npm/dt/homebridge-generac)](https://www.npmjs.com/package/homebridge-generac)
 [![License](https://img.shields.io/github/license/arodbuilds/homebridge-generac)](LICENSE)
 [![Build and Lint](https://github.com/arodbuilds/homebridge-generac/actions/workflows/build.yml/badge.svg)](https://github.com/arodbuilds/homebridge-generac/actions/workflows/build.yml)
@@ -15,7 +15,7 @@ A [Homebridge](https://homebridge.io) plugin that shows the standby generators o
 
 Not affiliated with or endorsed by Generac Power Systems, Inc. Generac and Mobile Link are its trademarks. Uses Generac's undocumented Mobile Link API, which can change without notice.
 
-> **Status:** Beta. Please report what works and what does not in the [issue tracker](https://github.com/arodbuilds/homebridge-generac/issues).
+> **Status:** 1.0.0, released September 26, 2026.
 
 ## Contents
 
@@ -37,16 +37,16 @@ Not affiliated with or endorsed by Generac Power Systems, Inc. Generac and Mobil
 ## Requirements
 
 - Homebridge 1.8 or 2.x, with the Homebridge UI for the settings page.
-- Node 20 or later.
+- Node 20, 22 or 24.
 - A Generac Mobile Link account with at least one generator on it.
 - If the account predates April 21, 2026, a password reset since then. Generac moved Mobile Link sign-in to a new system on that date and did not carry older passwords across, so an older password is rejected until it is reset in the Mobile Link app.
 
 ## Install
 
-Search for "Generac" under Plugins in the Homebridge UI and install the beta, or from a shell on the Homebridge host:
+Search for "Generac" under Plugins in the Homebridge UI and install it, or from a shell on the Homebridge host:
 
 ```shell
-npm i -g homebridge-generac@beta
+npm i -g homebridge-generac
 ```
 
 Then open the plugin's settings from the Plugins page. Everything in the setup below happens on that page. The host's Save button writes config.json and Homebridge restarts the plugin.
@@ -150,7 +150,7 @@ Every sensor also reports Status Active, which is off while the unit is not resp
 
 ## Development
 
-Node 20 or later. Clone the repository, then:
+Node 20, 22 or 24. Clone the repository, then:
 
 ```shell
 npm ci

package/SECURITY.md

@@ -2,6 +2,11 @@
 
 ## Supported versions
 
+| Version | Supported |
+|---|---|
+| 1.0.x | Yes |
+| 0.1.0-beta.x | No |
+
 Only the newest release receives security fixes. Older versions do not.
 
 ## Reporting a vulnerability

package/homebridge-ui/public/generac.css

@@ -219,15 +219,12 @@
   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. */
+/* The Reset dialog, in the page flow directly below the Reset link (SPEC section 11.2), never a fixed overlay. It
+   carries Bootstrap's `card` class, so its fill, border and text are the host's card surface in both themes; this
+   rule sets none of them (the host's dark theme leaves `--bs-body-bg` white and paints `.card` itself). */
 .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 {

package/homebridge-ui/public/index.css

@@ -81,9 +81,7 @@ body[class*="config-ui-x-dark-mode"] .generac-ui .card {
    colour, never Bootstrap's dimmed copy of the enabled button and never the host's dark fill. Pointer events stay
    on so the not-allowed cursor shows (a disabled button fires no click either way). */
 .generac-ui .btn:disabled,
-.generac-ui .btn.disabled,
-.ns-modal .btn:disabled,
-.ns-modal .btn.disabled {
+.generac-ui .btn.disabled {
   opacity: 1;
   color: var(--bs-secondary-color, currentColor);
   border-color: var(--bs-border-color, currentColor);
@@ -419,9 +417,7 @@ body[class*="config-ui-x-dark-mode"] .generac-ui .btn-link {
 /* Touch targets: every button, text buttons included, is at least 44px tall on touch devices. */
 @media (pointer: coarse) {
   .generac-ui .btn,
-  .generac-ui .btn-close,
-  .ns-modal .btn,
-  .ns-modal .btn-close {
+  .generac-ui .btn-close {
     min-height: 44px;
     display: inline-flex;
     align-items: center;
@@ -430,59 +426,13 @@ body[class*="config-ui-x-dark-mode"] .generac-ui .btn-link {
 }
 
 body.ns-touch .generac-ui .btn,
-body.ns-touch .generac-ui .btn-close,
-body.ns-touch .ns-modal .btn,
-body.ns-touch .ns-modal .btn-close {
+body.ns-touch .generac-ui .btn-close {
   min-height: 44px;
   display: inline-flex;
   align-items: center;
   justify-content: center;
 }
 
-/* Modal drawn by the page (the Reset dialog). */
-.ns-modal-backdrop {
-  position: fixed;
-  inset: 0;
-  z-index: 50;
-  background: rgba(0, 0, 0, 0.55);
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  padding: 1rem;
-}
-
-.ns-modal {
-  background: var(--bs-body-bg, #fff);
-  color: var(--bs-body-color, inherit);
-  border-radius: 0.5rem;
-  width: 100%;
-  max-width: 28rem;
-  max-height: 100%;
-  overflow: auto;
-  box-shadow: 0 0.5rem 1.5rem rgba(0, 0, 0, 0.3);
-}
-
-.ns-modal-header {
-  display: flex;
-  justify-content: space-between;
-  align-items: center;
-  padding: 0.75rem 1rem;
-  border-bottom: 1px solid var(--bs-border-color, rgba(128, 128, 128, 0.35));
-}
-
-.ns-modal-body {
-  padding: 1rem;
-}
-
-.ns-modal-actions {
-  display: flex;
-  flex-wrap: wrap;
-  justify-content: flex-end;
-  gap: 0.5rem;
-  padding: 0.75rem 1rem;
-  border-top: 1px solid var(--bs-border-color, rgba(128, 128, 128, 0.35));
-}
-
 /* Version and credit footer: one line of secondary text that wraps between its items on narrow screens. */
 .ns-footer {
   margin-top: 1.5rem;

package/homebridge-ui/public/js/copy.js

@@ -135,6 +135,9 @@ export const SETTINGS = {
         'Removes every generator and its sensors from the Home app.',
         'Clears all settings on this page.',
     ],
+    resetDoneTitle: 'Reset done',
+    resetDoneBody: 'Click Save, then restart Homebridge to remove the generators from the Home app. '
+        + 'Reconnect your Mobile Link account afterwards if you want them back.',
 };
 /** Shell strings (SPEC 11.3 F): the disclosure, the Reset dialog, the password toggle, the credit footer and relative times. */
 export const SHELL = {

package/homebridge-ui/public/js/dom.js

@@ -223,10 +223,12 @@ export function inlineConfirm(opts) {
 /**
  * A dialog in the page flow (the Reset dialog), drawn where it is opened rather than over the page: a fixed
  * overlay would pin to the iframe's own top, off-screen when the opener sits at the bottom of a scrolled host
- * modal. Escape closes it; `onClose` runs on every close, including the caller's.
+ * modal. Escape closes it; `onClose` runs on every close, including the caller's. It is a Bootstrap `card`, so
+ * the host paints it like every other card in both themes: the dark theme sets the card's fill and text itself and
+ * leaves `--bs-body-bg` at its light value, so a panel of its own would be white on the dark page (SPEC section 11.2).
  */
 export function inlineDialog(opts) {
-    const dialog = el('div', { class: 'ns-inline-dialog', role: 'dialog', 'aria-label': opts.title });
+    const dialog = el('div', { class: 'card ns-inline-dialog', role: 'dialog', 'aria-label': opts.title });
     let onKey = () => undefined;
     const close = () => {
         document.removeEventListener('keydown', onKey);

package/homebridge-ui/public/js/main.js

@@ -33,7 +33,7 @@ export class Page {
         this.config = config;
         this.root = root;
         this.status = null;
-        this.ui = { flow: null, disconnectOpen: false, resetOpen: false, rename: null, checkingSince: null };
+        this.ui = { flow: null, disconnectOpen: false, resetOpen: false, resetDone: false, rename: null, checkingSince: null };
         this.containers = new Map();
         this.touched = new Set();
         /** The messages currently shown inline, by path. A focused field only ever loses its message, never gains one. */

package/homebridge-ui/public/js/sections/settings.js

@@ -10,14 +10,17 @@ import { DEFAULTS, emptyConfig } from '../model.js';
 import { hasOneDecimal } from '../validate.js';
 /**
  * The Reset dialog: the three lines from SPEC section 11.3 E, "Type RESET to confirm.", Confirm disabled until
- * typed. It renders inline directly below the Reset link (SPEC section 11.2) and is page state, so a redraw of
- * the section keeps it open; opening it by click focuses the field and scrolls the host modal to the dialog.
+ * RESET is typed in any case. It renders inline directly below the Reset link (SPEC section 11.2) and is page state,
+ * so a redraw of the section keeps it open; opening it by click focuses the field and scrolls the host modal to the
+ * dialog. Confirm redraws the page with the done state in the dialog's place and scrolls the host to it.
  */
 function resetDialog(app, opened) {
     const confirmInput = el('input', { type: 'text', class: 'form-control', autocomplete: 'off', spellcheck: 'false', id: 'gn-reset-confirm' });
     let close = () => undefined;
     const confirm = button(SHELL.resetConfirm, () => {
         close();
+        // The done state replaces the dialog in place when the page is redrawn below (SPEC section 11.3 E).
+        app.ui.resetDone = true;
         // Sign out and forget the saved state on the server; the platform removes the accessories on its next start.
         void callServer('/reset').then(() => app.refreshStatus());
         if (app.status) {
@@ -28,10 +31,15 @@ function resetDialog(app, opened) {
         app.ui.rename = null;
         app.replaceConfig(emptyConfig());
         toastSuccess(SHELL.resetDone);
+        const done = document.querySelector('.gn-reset-done');
+        if (done) {
+            reveal(done);
+        }
     }, 'btn btn-danger btn-sm');
     confirm.disabled = true;
     confirmInput.addEventListener('input', () => {
-        confirm.disabled = confirmInput.value.trim() !== 'RESET';
+        // RESET in any case (SPEC section 11.3 E); the prompt still reads "Type RESET to confirm."
+        confirm.disabled = confirmInput.value.trim().toUpperCase() !== 'RESET';
     });
     const dialog = inlineDialog({
         title: SHELL.resetTitle,
@@ -50,9 +58,20 @@ function resetDialog(app, opened) {
     }
     return dialog.el;
 }
-/** The Reset link, with the dialog directly below it while open. */
+/**
+ * The done state after Confirm (SPEC section 11.3 E): the dialog's place on the page, a card with the title and one
+ * line, no buttons. It stays until the page reloads.
+ */
+function resetDoneState() {
+    return el('div', { class: 'card ns-inline-dialog gn-reset-done', role: 'status' }, el('div', { class: 'ns-inline-dialog-title fw-semibold' }, SETTINGS.resetDoneTitle), el('div', { class: 'ns-inline-dialog-body' }, el('p', { class: 'mb-0' }, SETTINGS.resetDoneBody)));
+}
+/** The Reset link, with the dialog directly below it while open; after Confirm, only the done state. */
 function resetControl(app) {
     const holder = el('div', { class: 'gn-reset' });
+    if (app.ui.resetDone) {
+        holder.appendChild(resetDoneState());
+        return holder;
+    }
     const link = dangerLinkButton(SHELL.reset, () => {
         if (app.ui.resetOpen) {
             return;

package/package.json

@@ -2,7 +2,7 @@
   "name": "homebridge-generac",
   "displayName": "Generac",
   "type": "module",
-  "version": "0.1.0-beta.1",
+  "version": "1.0.0",
   "description": "Generac Mobile Link standby generators in HomeKit: running, fault and maintenance sensors plus starting-battery health.",
   "author": "Alex Rodriguez (https://alex-rodriguez.com)",
   "license": "Apache-2.0",
@@ -40,7 +40,7 @@
     "SECURITY.md"
   ],
   "engines": {
-    "node": "^20.18.0 || ^22.10.0",
+    "node": "^20.18.0 || ^22.10.0 || ^24.0.0",
     "homebridge": "^1.8.0 || ^2.0.0-beta.0"
   },
   "scripts": {