homebridge-homeassistant-things 2.1.1 → 2.2.0

package/.github/workflows/publish.yml

@@ -9,13 +9,13 @@ jobs:
   publish:
     runs-on: ubuntu-latest
     permissions:
-      id-token: write
       contents: read
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
           node-version: '24'
-      - run: npm publish --provenance --access public
+          registry-url: 'https://registry.npmjs.org/'
+      - run: npm publish --access public
         env:
-          NPM_CONFIG_REGISTRY: https://registry.npmjs.org/
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CHANGELOG.md

@@ -10,6 +10,32 @@ Todos los cambios relevantes de este proyecto se documentan aquí.
 
 ---
 
+## [2.2.0] - 2026-04-02
+
+### Added / Añadido
+- **EN** New `deviceType: "pulse"` — momentary switch: sends `turn_on` to HA then auto `turn_off` after `pulseTime` ms. Useful for doorbells, relay pulses, etc.
+- **EN** New `deviceType: "button"` — stateless programmable switch: triggers HomeKit automations on press. No HA state sync needed.
+- **ES** Nuevo `deviceType: "pulse"` — pulsador momentáneo: envía `turn_on` a HA y luego `turn_off` automáticamente tras `pulseTime` ms. Útil para timbres, relés de pulso, etc.
+- **ES** Nuevo `deviceType: "button"` — botón sin estado: dispara automatizaciones HomeKit al pulsar. Sin sincronización de estado con HA.
+
+---
+
+## [2.1.3] - 2026-04-02
+
+### Changed / Cambios
+- **EN** Updated publish workflow to use npm token — author now shows correctly as @yagotorres in Homebridge plugin catalogue.
+- **ES** Actualizado el workflow de publicación para usar token npm — el autor ahora aparece correctamente como @yagotorres en el catálogo de plugins de Homebridge.
+
+---
+
+## [2.1.2] - 2026-04-02
+
+### Changed / Cambios
+- **EN** README: added troubleshooting section for users upgrading from v1.x — explains how to uninstall, clear cache, restart and reinstall to fix schema caching issues.
+- **ES** README: añadida sección de solución de problemas para usuarios que actualizan desde v1.x — explica cómo desinstalar, limpiar caché, reiniciar y reinstalar para resolver problemas de caché del schema.
+
+---
+
 ## [2.1.1] - 2026-04-02
 
 ### Changed / Cambios

package/README.md

@@ -83,6 +83,8 @@ Desde v2.0.0 el plugin es una **dynamic platform**. Mueve la config del bloque `
 | `blind`       | Window Covering    | `cover`          | Bidirectional |
 | `garageDoor`  | Garage Door Opener | `switch` (pulse relay) | One-way |
 | `sensor`      | Light Sensor       | `sensor` (any numeric) | Read-only |
+| `pulse`       | Switch (momentary) | `switch` (pulse relay) | One-way |
+| `button`      | Stateless Switch   | any (no state needed)  | One-way |
 
 ### Features
 
@@ -92,6 +94,8 @@ Desde v2.0.0 el plugin es una **dynamic platform**. Mueve la config del bloque `
 - Blind: open/close/stop, position 0–100%, moving state
 - Garage door: pulse relay logic (turn_on → 2s → turn_off)
 - Sensor: read-only numeric values (power, energy, temperature, etc.) — usable in HomeKit automations
+- Pulse: momentary switch — sends `turn_on` then auto `turn_off` after `pulseTime` ms. Useful for doorbells, relay pulses, etc.
+- Button: stateless programmable switch — triggers HomeKit automations on press. No state, no HA entity needed.
 - Config UI X form — no manual JSON editing required
 
 ### Installation
@@ -156,6 +160,21 @@ Full example with all device types:
         "closingTime": 15,
         "pulseTime": 2000
       },
+      {
+        "name": "Doorbell Relay",
+        "deviceType": "pulse",
+        "haUrl": "http://homeassistant.local:8123",
+        "haToken": "eyJhbGciOiJIUzI1NiIs...",
+        "entityId": "switch.doorbell_relay",
+        "pulseTime": 500
+      },
+      {
+        "name": "Scene Button",
+        "deviceType": "button",
+        "haUrl": "http://homeassistant.local:8123",
+        "haToken": "eyJhbGciOiJIUzI1NiIs...",
+        "entityId": "input_boolean.dummy"
+      },
       {
         "name": "Power Consumption",
         "deviceType": "sensor",
@@ -213,6 +232,8 @@ Scheduling is not a HomeKit accessory feature — it must be configured through
 | `blind`       | Persiana           | `cover`            | Bidireccional |
 | `garageDoor`  | Puerta de Garaje   | `switch` (relé pulso) | Unidireccional |
 | `sensor`      | Sensor de Luz      | `sensor` (cualquier numérico) | Solo lectura |
+| `pulse`       | Interruptor (momentáneo) | `switch` (relé de pulso) | Unidireccional |
+| `button`      | Interruptor sin estado | cualquiera (sin estado)  | Unidireccional |
 
 ### Características
 
@@ -222,6 +243,8 @@ Scheduling is not a HomeKit accessory feature — it must be configured through
 - Persiana: abrir/cerrar/parar, posición 0–100%, estado de movimiento
 - Puerta de garaje: lógica de relé de pulso (turn_on → 2s → turn_off)
 - Sensor: valores numéricos de solo lectura (potencia, energía, temperatura, etc.) — utilizables en automatizaciones HomeKit
+- Pulsador (`pulse`): interruptor momentáneo — envía `turn_on` y luego `turn_off` automáticamente tras `pulseTime` ms. Útil para timbres, relés de pulso, etc.
+- Botón (`button`): interruptor sin estado — dispara automatizaciones HomeKit al pulsar. Sin estado, sin necesidad de entidad HA.
 - Formulario automático en Config UI X
 
 ### Instalación
@@ -286,6 +309,21 @@ Ejemplo completo con todos los tipos de dispositivo:
         "closingTime": 15,
         "pulseTime": 2000
       },
+      {
+        "name": "Timbre",
+        "deviceType": "pulse",
+        "haUrl": "http://homeassistant.local:8123",
+        "haToken": "eyJhbGciOiJIUzI1NiIs...",
+        "entityId": "switch.rele_timbre",
+        "pulseTime": 500
+      },
+      {
+        "name": "Botón Escena",
+        "deviceType": "button",
+        "haUrl": "http://homeassistant.local:8123",
+        "haToken": "eyJhbGciOiJIUzI1NiIs...",
+        "entityId": "input_boolean.dummy"
+      },
       {
         "name": "Consumo eléctrico",
         "deviceType": "sensor",
@@ -325,6 +363,38 @@ La programación horaria no es una función del accesorio HomeKit — debe confi
 
 ---
 
+## Troubleshooting — after upgrading to v2.0.0 or later
+
+From v2.0.0 this plugin changed from `accessory` to `platform`. If Config UI X still generates `"accessory"` instead of `"platform"` after updating, follow these steps:
+
+1. **Uninstall the plugin** from Config UI X → Plugins → `homebridge-homeassistant-things` → Uninstall
+2. **Clear the Homebridge accessory cache**: Config UI X → Settings → scroll down → **Remove All Cached Accessories**
+3. **Restart the Homebridge container/service** completely:
+   - Docker: `docker restart homebridge`
+   - systemd: `sudo systemctl restart homebridge`
+4. **Reinstall the plugin** from Config UI X → search `homebridge-homeassistant-things` → Install
+5. **Add the plugin again** from the Config UI X assistant — it will now generate the correct `"platform"` config
+
+> This is necessary because Config UI X caches the plugin schema. A full restart forces it to reload the schema from the newly installed version.
+
+---
+
+## Solución de problemas — tras actualizar a v2.0.0 o superior
+
+Desde v2.0.0 este plugin cambió de `accessory` a `platform`. Si Config UI X sigue generando `"accessory"` en lugar de `"platform"` tras actualizar, sigue estos pasos:
+
+1. **Desinstala el plugin** desde Config UI X → Plugins → `homebridge-homeassistant-things` → Desinstalar
+2. **Limpia la caché de accesorios**: Config UI X → Ajustes → baja hasta **Eliminar todos los accesorios en caché**
+3. **Reinicia completamente el contenedor/servicio de Homebridge**:
+   - Docker: `docker restart homebridge`
+   - systemd: `sudo systemctl restart homebridge`
+4. **Vuelve a instalar el plugin** desde Config UI X → busca `homebridge-homeassistant-things` → Instalar
+5. **Añade el plugin de nuevo** desde el asistente de Config UI X — ahora generará la config correcta con `"platform"`
+
+> Esto es necesario porque Config UI X cachea el schema del plugin. Un reinicio completo fuerza la recarga del schema desde la versión recién instalada.
+
+---
+
 ## Changelog
 
 See [CHANGELOG.md](CHANGELOG.md) for version history.

package/config.schema.json

@@ -33,7 +33,9 @@
                 { "title": "Thermostat (climate entity)", "enum": ["thermostat"] },
                 { "title": "Blind / Shutter (cover entity)", "enum": ["blind"] },
                 { "title": "Garage Door (pulse relay)", "enum": ["garageDoor"] },
-                { "title": "Sensor (read-only numeric, e.g. power/energy)", "enum": ["sensor"] }
+                { "title": "Sensor (read-only numeric, e.g. power/energy)", "enum": ["sensor"] },
+                { "title": "Pulse (momentary switch — auto turn_off after pulseTime)", "enum": ["pulse"] },
+                { "title": "Button (stateless — triggers HomeKit automations)", "enum": ["button"] }
               ]
             },
             "haUrl": {

package/index.js

@@ -114,6 +114,8 @@ class ThingHandler {
       case 'blind':      this._setupBlind();      break;
       case 'garageDoor': this._setupGarageDoor(); break;
       case 'sensor':     this._setupSensor();     break;
+      case 'pulse':      this._setupPulse();      break;
+      case 'button':     this._setupButton();     break;
       default:           this._setupSwitch();
     }
   }
@@ -279,6 +281,41 @@ class ThingHandler {
     }
   }
 
+  // ─── PULSE (momentary switch — turn_on then auto turn_off) ──────────────
+
+  _setupPulse() {
+    const { Service, Characteristic } = this.hap;
+    this.state.on = false;
+
+    this.service = this.accessory.getService(Service.Switch)
+      || this.accessory.addService(Service.Switch, this.name);
+
+    this.service.getCharacteristic(Characteristic.On)
+      .onGet(() => false)
+      .onSet((value) => {
+        if (!value) return;
+        this.log.info(`[${this.name}] Pulse: turn_on → wait ${this.pulseTime}ms → turn_off`);
+        this._sendCommand('switch', 'turn_on', {});
+        setTimeout(() => {
+          this._sendCommand('switch', 'turn_off', {});
+          this.service.updateCharacteristic(Characteristic.On, false);
+        }, this.pulseTime);
+      });
+  }
+
+  // ─── BUTTON (stateless programmable switch — triggers HomeKit automations) ─
+
+  _setupButton() {
+    const { Service, Characteristic } = this.hap;
+
+    this.service = this.accessory.getService(Service.StatelessProgrammableSwitch)
+      || this.accessory.addService(Service.StatelessProgrammableSwitch, this.name);
+
+    // Only expose single press
+    this.service.getCharacteristic(Characteristic.ProgrammableSwitchEvent)
+      .setProps({ validValues: [Characteristic.ProgrammableSwitchEvent.SINGLE_PRESS] });
+  }
+
   // ─── SENSOR (read-only numeric, e.g. power/energy) ───────────────────────
 
   _setupSensor() {
@@ -296,6 +333,8 @@ class ThingHandler {
 
   async _pollHA() {
     if (this.deviceType === 'garageDoor') return;
+    if (this.deviceType === 'pulse')      return;
+    if (this.deviceType === 'button')     return;
     if (this.deviceType === 'sensor') { await this._pollSensor(); return; }
 
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-homeassistant-things",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "Homebridge plugin to control Home Assistant devices (switches, thermostats, blinds, garage doors) as native HomeKit accessories",
   "main": "index.js",
   "keywords": [