homebridge-intratone 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to `homebridge-intratone`. Versions follow [semver](https://semver.org/).
 
+## [0.4.2] - 2026-11-12
+
+### Fixed
+
+- The settings form still did not appear on first-time setup: config-ui-x only renders the schema
+  form once a config block exists (`pluginConfig.length`), which is empty before the first save.
+  The custom page now creates an empty config block before calling `showSchemaForm()`, so the
+  phone-number form shows on a fresh install. (0.4.1 only addressed the render timing.)
+
+## [0.4.1] - 2026-11-12
+
+### Fixed
+
+- The custom settings page showed only the Connection and door panels but not the normal form, so
+  the phone number could not be entered. The form is now rendered on the UI host's `ready` event
+  (with a timeout fallback) instead of synchronously, which dropped the message.
+
 ## [0.4.0] - 2026-11-11
 
 ### Added
@@ -128,6 +145,8 @@ two-way audio are out of scope.
   masked.
 - MIT license.
 
+[0.4.2]: https://github.com/jtoucas-DIMO/Homebridge-Intratone/releases/tag/v0.4.2
+[0.4.1]: https://github.com/jtoucas-DIMO/Homebridge-Intratone/releases/tag/v0.4.1
 [0.4.0]: https://github.com/jtoucas-DIMO/Homebridge-Intratone/releases/tag/v0.4.0
 [0.3.0]: https://github.com/jtoucas-DIMO/Homebridge-Intratone/releases/tag/v0.3.0
 [0.2.2]: https://github.com/jtoucas-DIMO/Homebridge-Intratone/releases/tag/v0.2.2

package/homebridge-ui/public/index.html

@@ -1,67 +1,95 @@
 <!-- Custom settings page for homebridge-config-ui-x.
      Shows the live connection values and the detected doors (with inline rename) above the form.
-     The standard form is always rendered first, so the page is never blank if a request fails. -->
+     The standard form (phone number, etc.) is shown via showSchemaForm() AFTER the UI host signals
+     'ready' — posting it earlier drops the message and the form never appears. -->
 <div id="intratone-info" class="mb-3"></div>
 <div id="intratone-doors" class="mb-3"></div>
 
 <script>
-  (async () => {
-    // Base form first — if anything below throws, the normal settings still render.
-    try {
-      homebridge.showSchemaForm();
-    } catch (error) {
-      console.error('showSchemaForm failed', error);
+  let started = false;
+
+  async function init() {
+    if (started) {
+      return;
     }
+    started = true;
 
     const info = document.getElementById('intratone-info');
     const doors = document.getElementById('intratone-doors');
 
     let block;
     try {
-      const configs = await homebridge.getPluginConfig();
+      let configs = await homebridge.getPluginConfig();
+      if (!configs.length) {
+        // config-ui-x renders the schema form only once a config block exists (it gates on
+        // pluginConfig.length). Create an empty one so the phone-number form appears on first setup.
+        await homebridge.updatePluginConfig([{ platform: 'Intratone', name: 'Intratone' }]);
+        configs = await homebridge.getPluginConfig();
+      }
       block = configs[0] || { platform: 'Intratone', name: 'Intratone' };
     } catch (error) {
-      return; // No config access: just leave the standard form.
+      try { homebridge.showSchemaForm(); } catch (e) { console.error(e); }
+      return;
+    }
+
+    // With a config block present, the standard form (phone number, service, Advanced) renders.
+    try {
+      homebridge.showSchemaForm();
+    } catch (error) {
+      console.error('showSchemaForm failed', error);
     }
 
-    homebridge.showSpinner();
-    const [status, accesses] = await Promise.allSettled([
-      homebridge.request('/status', { config: block }),
-      homebridge.request('/accesses', { config: block }),
-    ]);
-    homebridge.hideSpinner();
+    let status;
+    let accesses;
+    try {
+      homebridge.showSpinner();
+      [status, accesses] = await Promise.allSettled([
+        homebridge.request('/status', { config: block }),
+        homebridge.request('/accesses', { config: block }),
+      ]);
+    } finally {
+      homebridge.hideSpinner();
+    }
 
     renderInfo(info, status);
     renderDoors(doors, block, accesses);
-  })();
+  }
+
+  // The form must be shown after the host is ready; a timeout covers the case where 'ready'
+  // already fired before this listener was attached.
+  homebridge.addEventListener('ready', init);
+  setTimeout(init, 1500);
 
   function note(parent, text) {
-    parent.innerHTML = '<p class="help-block text-muted">' + text + '</p>';
+    const p = document.createElement('p');
+    p.className = 'help-block text-muted';
+    p.textContent = text;
+    parent.appendChild(p);
   }
 
   function renderInfo(container, settled) {
+    container.innerHTML = '';
     const title = document.createElement('h5');
     title.textContent = 'Connection';
     container.appendChild(title);
 
-    if (settled.status !== 'fulfilled') {
-      const reason = settled.reason && settled.reason.message ? settled.reason.message : 'not connected yet';
-      const p = document.createElement('p');
-      p.className = 'help-block text-muted';
-      p.textContent = 'Not connected (' + reason + '). Fill in the phone number and save, then reopen.';
-      container.appendChild(p);
+    if (!settled || settled.status !== 'fulfilled') {
+      const reason = settled && settled.reason && settled.reason.message ? settled.reason.message : 'not connected yet';
+      note(container, 'Not connected (' + reason + '). Set the phone number below, press Save, then reopen this screen.');
       return;
     }
     const s = settled.value;
+    const session = s.session || {};
+    const flags = s.flags || {};
     const rows = [
       ['Device ID', s.deviceId + (s.generatedDeviceId ? ' (generated)' : '')],
       ['App ID', s.appId],
       ['App version', s.appVersion],
       ['Client', s.identity],
-      ['Session valid until', s.session && s.session.validUntil],
-      ['Smartphone ID', s.session && s.session.smartphoneId],
-      ['Mobipass key held here', s.flags ? (s.flags.mobipass ? 'yes' : 'no') : '?'],
-      ['Mobipass account', s.flags ? (s.flags.mobipassCompatible ? 'yes' : 'no') : '?'],
+      ['Session valid until', session.validUntil],
+      ['Smartphone ID', session.smartphoneId],
+      ['Mobipass key held here', s.flags ? (flags.mobipass ? 'yes' : 'no') : '?'],
+      ['Mobipass account', s.flags ? (flags.mobipassCompatible ? 'yes' : 'no') : '?'],
       ['State file', s.stateFile],
     ];
     const dl = document.createElement('dl');
@@ -102,28 +130,23 @@
   }
 
   function renderDoors(container, block, settled) {
+    container.innerHTML = '';
     const title = document.createElement('h5');
     title.textContent = 'Your doors';
     container.appendChild(title);
 
-    if (settled.status !== 'fulfilled') {
-      const reason = settled.reason && settled.reason.message ? settled.reason.message : 'unavailable';
-      const p = document.createElement('p');
-      p.className = 'help-block text-muted';
-      p.textContent = 'Could not list your doors (' + reason + '). You can still rename them by editing config.json (access_names); unnamed doors keep their detected names in the Home app.';
-      container.appendChild(p);
+    if (!settled || settled.status !== 'fulfilled') {
+      const reason = settled && settled.reason && settled.reason.message ? settled.reason.message : 'unavailable';
+      note(container, 'Could not list your doors (' + reason + '). Set the phone number below and Save first. You can also rename doors in config.json (access_names); unnamed doors keep their detected names in the Home app.');
       return;
     }
 
     const list = (settled.value && settled.value.openable) || [];
     const map = overridesFromConfig(block);
 
-    const hint = document.createElement('p');
-    hint.className = 'help-block text-muted';
-    hint.textContent = list.length
+    note(container, list.length
       ? 'Type a name to show it in the Home app. Leave blank to keep the detected name. Press Save below to apply.'
-      : 'No openable doors detected yet. Once they appear, you can rename them here.';
-    container.appendChild(hint);
+      : 'No openable doors detected yet. Once they appear, you can rename them here.');
 
     for (const door of list) {
       const group = document.createElement('div');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-intratone",
   "displayName": "Intratone",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Unofficial Homebridge plugin to open Intratone / Cogelec doors and gates from HomeKit and Matter (remote open, no doorbell).",
   "license": "MIT",
   "author": "jtoucas-DIMO",