homebridge-multiple-switch 1.1.6 → 1.3.0

package/.github/workflows/ci.yml

@@ -11,31 +11,20 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - name: 📥 Repo-nu klonla
-        uses: actions/checkout@v3
+      - name: Checkout
+        uses: actions/checkout@v4
 
-      - name: ⚙️ Node.js qur
-        uses: actions/setup-node@v3
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
         with:
           node-version: '18'
           cache: 'npm'
 
-      - name: 📦 Asılılıqları qur
+      - name: Install dependencies
         run: npm install
 
-      - name: ✅ Kod yoxlaması (lint varsa)
-        run: |
-          if [ -f .eslintrc.js ] || [ -f .eslintrc.json ]; then
-            npm run lint
-          else
-            echo "Lint skripti tapılmadı, keçilir..."
-          fi
-
-      - name: 🧪 Testləri icra et (əgər varsa)
-        run: |
-          if [ -f package.json ] && grep -q '\"test\"' package.json; then
-            npm test
-          else
-            echo "Test skripti yoxdur, keçilir..."
-          fi
+      - name: Lint
+        run: npm run lint
 
+      - name: Test
+        run: npm test

package/.github/workflows/release.yml

@@ -1,4 +1,4 @@
-name: 📦 Publish to npm
+name: Publish to npm
 
 on:
   push:
@@ -10,19 +10,19 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - name: 📥 Repo-nu klonla
-        uses: actions/checkout@v3
+      - name: Checkout
+        uses: actions/checkout@v4
 
-      - name: ⚙️ Node.js qur
-        uses: actions/setup-node@v3
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
         with:
           node-version: '18'
           registry-url: 'https://registry.npmjs.org/'
 
-      - name: 📦 Asılılıqları qur
+      - name: Install dependencies
         run: npm install
 
-      - name: 🚀 NPM-ə yüklə
+      - name: Publish to npm
         run: npm publish
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+## [1.3.0] - 2026-03-21
+
+### Changed
+- Replaced global mutable variables with instance properties
+- Refactored accessory setup to reuse cached accessories instead of creating duplicates on restart
+- Extracted switch behavior logic into dedicated methods (`turnOffOthers`, `setAll`, `scheduleAutoOff`)
+- Used `Map` for service and accessory tracking instead of plain objects
+- Service type lookup uses a constant map instead of a switch statement
+- Auto-off now checks current state before turning off (prevents stale timeouts)
+- Updated minimum Node.js version from 14 to 18
+- Updated GitHub Actions from v3 to v4
+- Cleaned up CI workflow
+
+### Fixed
+- `delayOff` not working in `master` mode due to if/else logic bug
+- Cached accessories not being restored on Homebridge restart (caused duplicate accessories)
+- Services stored in `accessory.context` which is not serializable
+- README field names (`autoTurnOff`, `mode`) now match actual config schema (`delayOff`, `switchBehavior`)
+
+### Added
+- Automatic removal of stale cached accessories when config changes
+- Service reconciliation: adds new services and removes old ones on config update
+- Validation for empty or missing switches array
+
+## [1.2.0] - 2025-01-01
+
+- Initial published version with independent, master, and single switch modes
+- Support for switch, outlet, lightbulb, and fan accessory types
+- Per-switch config: type, defaultState, delayOff
+- Homebridge UI config schema

package/README.md

@@ -1,34 +1,38 @@
 # homebridge-multiple-switch
 
+![CI](https://github.com/azadaydinli/homebridge-multiple-switch/actions/workflows/ci.yml/badge.svg)
 [![npm](https://img.shields.io/npm/v/homebridge-multiple-switch)](https://www.npmjs.com/package/homebridge-multiple-switch)
 [![GitHub issues](https://img.shields.io/github/issues/azadaydinli/homebridge-multiple-switch)](https://github.com/azadaydinli/homebridge-multiple-switch/issues)
 [![GitHub license](https://img.shields.io/github/license/azadaydinli/homebridge-multiple-switch)](https://github.com/azadaydinli/homebridge-multiple-switch/blob/master/LICENSE)
 
-A lightweight Homebridge plugin that lets you create multiple customizable dummy switches (Outlet/Fan/Light/Switch) with different behavior modes including Independent, Master, and Single-Switch Mode.
+A lightweight Homebridge plugin that lets you create multiple customizable dummy switches under a single accessory — configurable as `Switch`, `Outlet`, `Lightbulb`, or `Fan`.
+Supports `Independent`, `Master`, and `Single` switch modes.
 
 ---
 
-## ✨ Features
+## Features
 
-- Multiple switches in a single accessory
-- Each switch can be `switch`, `outlet`, `lightbulb`, or `fan`
-- **Independent Mode** – all switches work separately
-- **Master Mode** – adds a master switch that controls all other switches
-- **Single Mode** – only one switch can be on at any time
-- Auto turn-off (in milliseconds)
-- Works seamlessly with HomeKit and Siri
+- Grouped multiple switches in one HomeKit tile
+- Accessory type: `switch`, `outlet`, `lightbulb`, or `fan`
+- **Independent Mode** – All switches operate separately
+- **Master Mode** – One switch controls all others
+- **Single Mode** – Only one switch can be active at a time
+- Per-switch config support (type, auto-off delay, default state)
+- Switch states preserved across Homebridge restarts via cached accessories
+- Automatic cleanup of stale accessories on config change
+- Compatible with HomeKit and Siri
 
 ---
 
-## 📦 Installation
+## Installation
 
-Install the plugin via the Homebridge UI:
+Install via Homebridge UI:
 
-1. Go to **Plugins**
+1. Open **Plugins**
 2. Search for `homebridge-multiple-switch`
 3. Click **Install**
 
-Or use the command line:
+Or install via terminal:
 
 ```bash
 npm install -g homebridge-multiple-switch
@@ -36,35 +40,73 @@ npm install -g homebridge-multiple-switch
 
 ---
 
-## ⚙️ Configuration
+## Configuration
 
-You can configure the plugin directly via the Homebridge UI, or manually in config.json:
+Configure from Homebridge UI or manually edit `config.json`:
 
-```bash
+```json
 {
-  "accessory": "MultipleSwitchAccessory",
-  "name": "My Multi Switch",
-  "switchCount": 3,
-  "type": "outlet",
-  "mode": "independent",
-  "autoTurnOff": 1000,
-  "defaultState": false,
-  "states": [
-    { "type": "switch", "autoTurnOff": 3000 },
-    { "type": "fan" },
-    { "type": "lightbulb", "defaultState": true }
+  "platform": "MultipleSwitchPlatform",
+  "name": "Multiple Switches",
+  "switchBehavior": "single",
+  "switches": [
+    {
+      "name": "Heater",
+      "type": "outlet",
+      "defaultState": true,
+      "delayOff": 10000
+    },
+    {
+      "name": "Fan",
+      "type": "fan"
+    },
+    {
+      "name": "Light",
+      "type": "lightbulb",
+      "delayOff": 5000
+    }
   ]
 }
 ```
 
-### 🔧 Configuration Options
-
-| Field         | Type    | Required | Description                                                                 |
-|---------------|---------|----------|-----------------------------------------------------------------------------|
-| `name`        | string  | ✅       | Name of the accessory                                                       |
-| `switchCount` | number  | ✅       | Number of switches to create (max depends on HomeKit limits)               |
-| `type`        | string  | ❌       | Default type: `switch`, `outlet`, `lightbulb`, or `fan`                    |
-| `mode`        | string  | ❌       | `independent`, `master`, or `single`                                       |
-| `autoTurnOff` | number  | ❌       | Global auto-off in milliseconds                                            |
-| `defaultState`| boolean | ❌       | Default on/off state on restart                                            |
-| `states`      | array   | ❌       | Per-switch custom settings (overrides global config)                       |
+---
+
+### Platform Options
+
+| Field            | Type   | Required | Description                          |
+|------------------|--------|----------|--------------------------------------|
+| `name`           | string | Yes      | Name of the platform instance        |
+| `switchBehavior` | string | No       | `independent`, `master`, or `single` |
+| `switches`       | array  | Yes      | List of switches to create           |
+
+### Per-Switch Options
+
+| Field          | Type    | Required | Description                                      |
+|----------------|---------|----------|--------------------------------------------------|
+| `name`         | string  | Yes      | Name of the switch                               |
+| `type`         | string  | No       | `switch`, `outlet`, `lightbulb`, or `fan`        |
+| `defaultState` | boolean | No       | Initial power state (default: `false`)           |
+| `delayOff`     | number  | No       | Auto turn off after N milliseconds (default: `0`) |
+
+---
+
+## Example Use Cases
+
+- Simulate smart plugs for automation testing
+- Trigger HomeKit scenes manually
+- Create virtual switches for non-HomeKit devices
+- Combine several virtual accessories under one tile
+
+---
+
+## Links
+
+- [NPM Package](https://www.npmjs.com/package/homebridge-multiple-switch)
+- [Homebridge](https://homebridge.io/)
+- [Plugin Issues](https://github.com/azadaydinli/homebridge-multiple-switch/issues)
+
+---
+
+## License
+
+MIT © [Azad Aydınlı](https://github.com/azadaydinli)

package/index.js

@@ -1,109 +1,160 @@
-// homebridge-multiple-switch: index.js (Platform plugin, bir Accessory, çox Service)
+'use strict';
 
-let Service, Characteristic, UUIDGen;
+const PLUGIN_NAME = 'homebridge-multiple-switch';
+const PLATFORM_NAME = 'MultipleSwitchPlatform';
 
-module.exports = (api) => {
-  Service = api.hap.Service;
-  Characteristic = api.hap.Characteristic;
-  UUIDGen = api.hap.uuid;
+const SERVICE_TYPES = {
+  switch: 'Switch',
+  lightbulb: 'Lightbulb',
+  fan: 'Fan',
+  outlet: 'Outlet',
+};
 
-  api.registerPlatform('MultipleSwitchPlatform', MultipleSwitchPlatform);
+module.exports = (api) => {
+  api.registerPlatform(PLATFORM_NAME, MultipleSwitchPlatform);
 };
 
 class MultipleSwitchPlatform {
   constructor(log, config, api) {
     this.log = log;
-    this.config = config;
+    this.config = config || {};
     this.api = api;
-    this.accessories = [];
+    this.Service = api.hap.Service;
+    this.Characteristic = api.hap.Characteristic;
+    this.cachedAccessories = new Map();
+    this.switchServices = new Map();
 
     this.api.on('didFinishLaunching', () => {
-      this.log('🔌 MultipleSwitchPlatform başladıldı.');
+      this.log.info('MultipleSwitchPlatform started.');
       this.setupAccessories();
     });
   }
 
+  configureAccessory(accessory) {
+    this.cachedAccessories.set(accessory.UUID, accessory);
+  }
+
   setupAccessories() {
-    const switches = this.config.switches || [];
-    const behavior = this.config.switchBehavior || 'independent';
+    const switches = this.config.switches;
+    if (!Array.isArray(switches) || switches.length === 0) {
+      this.log.warn('No switches configured. Removing stale accessories.');
+      this.removeStaleCachedAccessories();
+      return;
+    }
+
     const name = this.config.name || 'Multiple Switch Panel';
+    const behavior = this.config.switchBehavior || 'independent';
+    const uuid = this.api.hap.uuid.generate(name);
+
+    let accessory = this.cachedAccessories.get(uuid);
+    const isNew = !accessory;
 
-    const uuid = UUIDGen.generate(name);
-    const accessory = new this.api.platformAccessory(name, uuid);
+    if (isNew) {
+      accessory = new this.api.platformAccessory(name, uuid);
+    }
 
-    accessory.context.switchStates = {};
-    accessory.context.switchServices = {};
     accessory.context.switchBehavior = behavior;
+    accessory.context.switchStates = accessory.context.switchStates || {};
+
+    this.reconcileServices(accessory, switches);
+
+    if (isNew) {
+      this.api.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [accessory]);
+    }
+
+    this.cachedAccessories.delete(uuid);
+    this.removeStaleCachedAccessories();
+  }
+
+  reconcileServices(accessory, switches) {
+    const activeSubtypes = new Set();
 
     switches.forEach((sw, index) => {
-      const id = `switch_${index}`;
-      const service = this.createSwitchService(accessory, sw, id);
+      const subtype = `switch_${index}`;
+      activeSubtypes.add(subtype);
 
-      accessory.addService(service);
-      accessory.context.switchStates[id] = sw.defaultState || false;
-      accessory.context.switchServices[id] = service;
+      const ServiceClass = this.getServiceClass(sw.type);
+      let service = accessory.getServiceById(ServiceClass, subtype);
+
+      if (!service) {
+        service = accessory.addService(ServiceClass, sw.name, subtype);
+      }
+
+      service.setCharacteristic(this.Characteristic.Name, sw.name);
+      this.configureSwitchHandlers(accessory, service, sw, subtype);
+
+      this.switchServices.set(subtype, service);
+
+      if (accessory.context.switchStates[subtype] === undefined) {
+        accessory.context.switchStates[subtype] = sw.defaultState || false;
+      }
     });
 
-    this.api.registerPlatformAccessories(
-      'homebridge-multiple-switch',
-      'MultipleSwitchPlatform',
-      [accessory]
-    );
-    this.accessories.push(accessory);
+    const servicesToRemove = accessory.services.filter((s) => {
+      return s.subtype && !activeSubtypes.has(s.subtype);
+    });
+    servicesToRemove.forEach((s) => accessory.removeService(s));
   }
 
-  createSwitchService(accessory, sw, id) {
-    const ServiceType = this.getServiceClass(sw.type);
-    const service = new ServiceType(sw.name, id);
-
-    service.getCharacteristic(Characteristic.On)
-      .onGet(() => {
-        return accessory.context.switchStates[id];
-      })
+  configureSwitchHandlers(accessory, service, sw, subtype) {
+    service.getCharacteristic(this.Characteristic.On)
+      .onGet(() => accessory.context.switchStates[subtype] ?? false)
       .onSet((value) => {
+        accessory.context.switchStates[subtype] = value;
+        this.log.info(`[${sw.name}] ${value ? 'ON' : 'OFF'}`);
+
         const behavior = accessory.context.switchBehavior;
-        accessory.context.switchStates[id] = value;
-        this.log(`[${sw.name}] → ${value ? 'ON' : 'OFF'}`);
 
         if (behavior === 'single' && value) {
-          Object.keys(accessory.context.switchStates).forEach(key => {
-            if (key !== id) {
-              accessory.context.switchStates[key] = false;
-              accessory.context.switchServices[key].updateCharacteristic(Characteristic.On, false);
-            }
-          });
+          this.turnOffOthers(accessory, subtype);
         }
 
         if (behavior === 'master') {
-          Object.keys(accessory.context.switchStates).forEach(key => {
-            accessory.context.switchStates[key] = value;
-            accessory.context.switchServices[key].updateCharacteristic(Characteristic.On, value);
-          });
-        } else {
-          if (value && sw.delayOff > 0) {
-            setTimeout(() => {
-              accessory.context.switchStates[id] = false;
-              service.updateCharacteristic(Characteristic.On, false);
-              this.log(`[${sw.name}] auto-off after ${sw.delayOff}ms`);
-            }, sw.delayOff);
-          }
+          this.setAll(accessory, value);
+        }
+
+        if (value && sw.delayOff > 0) {
+          this.scheduleAutoOff(accessory, service, sw, subtype);
         }
       });
+  }
 
-    return service;
+  turnOffOthers(accessory, excludeSubtype) {
+    for (const [key, svc] of this.switchServices) {
+      if (key !== excludeSubtype) {
+        accessory.context.switchStates[key] = false;
+        svc.updateCharacteristic(this.Characteristic.On, false);
+      }
+    }
   }
 
-  getServiceClass(type) {
-    switch ((type || '').toLowerCase()) {
-      case 'switch': return Service.Switch;
-      case 'lightbulb': return Service.Lightbulb;
-      case 'fan': return Service.Fan;
-      case 'outlet':
-      default: return Service.Outlet;
+  setAll(accessory, value) {
+    for (const [key, svc] of this.switchServices) {
+      accessory.context.switchStates[key] = value;
+      svc.updateCharacteristic(this.Characteristic.On, value);
     }
   }
 
-  configureAccessory(accessory) {
-    this.accessories.push(accessory);
+  scheduleAutoOff(accessory, service, sw, subtype) {
+    setTimeout(() => {
+      if (accessory.context.switchStates[subtype]) {
+        accessory.context.switchStates[subtype] = false;
+        service.updateCharacteristic(this.Characteristic.On, false);
+        this.log.info(`[${sw.name}] auto-off after ${sw.delayOff}ms`);
+      }
+    }, sw.delayOff);
+  }
+
+  getServiceClass(type) {
+    const key = (type || 'outlet').toLowerCase();
+    const name = SERVICE_TYPES[key] || SERVICE_TYPES.outlet;
+    return this.Service[name];
+  }
+
+  removeStaleCachedAccessories() {
+    if (this.cachedAccessories.size === 0) return;
+    const stale = [...this.cachedAccessories.values()];
+    this.api.unregisterPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, stale);
+    this.cachedAccessories.clear();
   }
 }

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "homebridge-multiple-switch",
-  "version": "1.1.6",
+  "version": "1.3.0",
   "description": "Multiple switch platform for Homebridge",
   "homepage": "https://github.com/azadaydinli/homebridge-multiple-switch",
   "main": "index.js",
   "author": "Azad Aydınlı",
   "license": "ISC",
+  "scripts": {
+    "lint": "echo \"No linter configured\"",
+    "test": "echo \"No tests configured\""
+  },
   "bugs": {
     "url": "https://github.com/azadaydinli/homebridge-multiple-switch/issues"
   },
@@ -26,7 +30,7 @@
     "url": "https://github.com/azadaydinli/homebridge-multiple-switch.git"
   },
   "engines": {
-    "node": ">=14.17.0",
+    "node": ">=18.0.0",
     "homebridge": ">=1.3.0"
   }
-}
+}