homebridge-homeassistant-things 2.1.2 → 2.3.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.3.0] - 2026-04-02
+
+### Added / Añadido
+- **EN** Platform-level `haUrl` and `haToken` defaults — set them once at platform level and all devices inherit them. Individual devices can still override with their own values.
+- **ES** Valores por defecto de `haUrl` y `haToken` a nivel de plataforma — se configuran una vez y todos los dispositivos los heredan. Cada dispositivo puede sobrescribirlos con sus propios valores si es necesario.
+
+---
+
+## [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

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",

package/config.schema.json

@@ -10,13 +10,24 @@
         "type": "string",
         "default": "HA Things"
       },
+      "haUrl": {
+        "title": "Default Home Assistant URL",
+        "type": "string",
+        "placeholder": "http://homeassistant.local:8123",
+        "description": "Default HA URL for all devices. Can be overridden per device."
+      },
+      "haToken": {
+        "title": "Default Long-Lived Access Token",
+        "type": "string",
+        "description": "Default HA token for all devices. Can be overridden per device."
+      },
       "devices": {
         "title": "Devices",
         "type": "array",
         "items": {
           "title": "Device",
           "type": "object",
-          "required": ["name", "deviceType", "haUrl", "entityId", "haToken"],
+          "required": ["name", "deviceType", "entityId"],
           "properties": {
             "name": {
               "title": "Name",
@@ -33,7 +44,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

@@ -44,6 +44,17 @@ class HomeAssistantThingsPlatform {
       }];
     }
 
+    // Apply platform-level defaults for haUrl and haToken
+    const defaultHaUrl   = this.config.haUrl;
+    const defaultHaToken = this.config.haToken;
+    if (defaultHaUrl || defaultHaToken) {
+      devices = devices.map(d => ({
+        haUrl:   defaultHaUrl,
+        haToken: defaultHaToken,
+        ...d,
+      }));
+    }
+
     const configuredUUIDs = new Set();
 
     for (const deviceConfig of devices) {
@@ -114,6 +125,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 +292,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 +344,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.2",
+  "version": "2.3.0",
   "description": "Homebridge plugin to control Home Assistant devices (switches, thermostats, blinds, garage doors) as native HomeKit accessories",
   "main": "index.js",
   "keywords": [