homebridge-multiple-switch 1.1.3 → 1.1.5

package/.github/workflows/ci.yml

@@ -0,0 +1,41 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 📥 Repo-nu klonla
+        uses: actions/checkout@v3
+
+      - name: ⚙️ Node.js qur
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: 📦 Asılılıqları qur
+        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
+

package/.github/workflows/release.yml

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

package/README.md

@@ -1,17 +1,70 @@
-# Homebridge Multiple Switch Plugin
-
-## Overview
-The **Homebridge Multiple Switch** plugin allows you to create and manage multiple virtual switches within the HomeKit environment. This plugin is ideal for users who want to control multiple devices or scenarios using a single accessory with multiple switch options.
-
-## Features
-- **Multiple Switches**: Add, manage, and control multiple virtual switches under one accessory in HomeKit.
-- **Master Switch**: Optionally add a master switch that controls all other switches simultaneously.
-- **Customizable**: Easily configure the number of switches and their names through the Homebridge UI.
-- **Flexible**: Supports dynamic addition of switches, allowing for easy scaling to your needs.
-
-## Installation
-1. Ensure you have [Homebridge](https://homebridge.io) installed and running.
-2. Install the plugin via Homebridge or npm:
-   ```bash
-   npm install -g homebridge-multiple-switch
-3. Configure the plugin through the Homebridge UI or manually edit your config.json.
+# homebridge-multiple-switch
+
+[![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.
+
+---
+
+## ✨ 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
+
+---
+
+## 📦 Installation
+
+Install the plugin via the Homebridge UI:
+
+1. Go to **Plugins**
+2. Search for `homebridge-multiple-switch`
+3. Click **Install**
+
+Or use the command line:
+
+```bash
+npm install -g homebridge-multiple-switch
+```
+
+---
+
+## ⚙️ Configuration
+
+You can configure the plugin directly via the Homebridge UI, or manually in config.json:
+
+```bash
+{
+  "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 }
+  ]
+}
+```
+
+### 🔧 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)                       |

package/config.schema.json

@@ -1,39 +1,23 @@
 {
-  "pluginAlias": "MultipleSwitchAccessory",
-  "pluginType": "accessory",
-  "singular": false,
-  "headerDisplay": "Multiple Switch Accessory",
+  "pluginAlias": "MultipleSwitchPlatform",
+  "pluginType": "platform",
+  "headerDisplay": "Multiple Switch Platform",
   "schema": {
     "type": "object",
     "properties": {
       "name": {
-        "title": "Accessory Name",
+        "title": "Platform Name",
         "type": "string",
-        "default": "Multiple Switch"
+        "default": "Multiple Switch Platform"
       },
       "switchBehavior": {
         "title": "Switch Behavior Mode",
         "type": "string",
         "default": "independent",
         "oneOf": [
-          {
-            "title": "Independent",
-            "enum": [
-              "independent"
-            ]
-          },
-          {
-            "title": "Master",
-            "enum": [
-              "master"
-            ]
-          },
-          {
-            "title": "Single",
-            "enum": [
-              "single"
-            ]
-          }
+          { "title": "Independent", "enum": ["independent"] },
+          { "title": "Master", "enum": ["master"] },
+          { "title": "Single", "enum": ["single"] }
         ]
       },
       "switches": {
@@ -51,30 +35,10 @@
               "type": "string",
               "default": "outlet",
               "oneOf": [
-                {
-                  "title": "Switch",
-                  "enum": [
-                    "switch"
-                  ]
-                },
-                {
-                  "title": "Outlet",
-                  "enum": [
-                    "outlet"
-                  ]
-                },
-                {
-                  "title": "Lightbulb",
-                  "enum": [
-                    "lightbulb"
-                  ]
-                },
-                {
-                  "title": "Fan",
-                  "enum": [
-                    "fan"
-                  ]
-                }
+                { "title": "Switch", "enum": ["switch"] },
+                { "title": "Outlet", "enum": ["outlet"] },
+                { "title": "Lightbulb", "enum": ["lightbulb"] },
+                { "title": "Fan", "enum": ["fan"] }
               ]
             },
             "defaultState": {
@@ -89,10 +53,7 @@
               "minimum": 0
             }
           },
-          "required": [
-            "name",
-            "type"
-          ]
+          "required": ["name", "type"]
         },
         "default": [
           {
@@ -104,9 +65,6 @@
         ]
       }
     },
-    "required": [
-      "name",
-      "switches"
-    ]
+    "required": ["name", "switches"]
   }
 }

package/index.js

@@ -1,78 +1,109 @@
-let Accessory, Service, Characteristic;
-
-module.exports = (homebridge) => {
-  Accessory = homebridge.platformAccessory || homebridge.hap.Accessory;
-  Service = homebridge.hap.Service;
-  Characteristic = homebridge.hap.Characteristic;
-
-  homebridge.registerAccessory(
-    'homebridge-multiple-switch',
-    'MultipleSwitchAccessory',
-    MultipleSwitchAccessory
-  );
+// homebridge-multiple-switch: index.js (Platform plugin, bir Accessory, çox Service)
+
+let Service, Characteristic, UUIDGen;
+
+module.exports = (api) => {
+  Service = api.hap.Service;
+  Characteristic = api.hap.Characteristic;
+  UUIDGen = api.hap.uuid;
+
+  api.registerPlatform('MultipleSwitchPlatform', MultipleSwitchPlatform);
 };
 
-class MultipleSwitchAccessory {
-  constructor(log, config) {
+class MultipleSwitchPlatform {
+  constructor(log, config, api) {
     this.log = log;
     this.config = config;
-    this.name = config.name || 'Multiple Switch';
-    this.switches = config.switches || [];
-    this.services = [];
-
-    const infoService = new Service.AccessoryInformation()
-      .setCharacteristic(Characteristic.Manufacturer, 'Custom')
-      .setCharacteristic(Characteristic.Model, 'MultipleSwitch')
-      .setCharacteristic(Characteristic.SerialNumber, 'v1.0.0');
-
-    this.services.push(infoService);
-
-    const serviceTypes = {
-      switch: Service.Switch,
-      outlet: Service.Outlet,
-      lightbulb: Service.Lightbulb,
-      fan: Service.Fan
-    };
-
-    this.switches.forEach((conf, index) => {
-      const switchName = conf.name || `Switch ${index + 1}`;
-      const type = (conf.type || 'outlet').toLowerCase();
-      const ServiceClass = serviceTypes[type];
-
-      if (!ServiceClass) {
-        this.log.warn(`"${switchName}" üçün tanınmayan növ: "${type}". Default olaraq Outlet istifadə olunur.`);
-        return;
-      }
-
-      conf.state = conf.defaultState === true;
-
-      const service = new ServiceClass(switchName, `subtype-${index}`);
-
-      service
-        .getCharacteristic(Characteristic.On)
-        .on('get', (callback) => {
-          callback(null, conf.state);
-        })
-        .on('set', (value, callback) => {
-          conf.state = value;
-          this.log(`"${switchName}" vəziyyəti dəyişdi: ${value}`);
-
-          if (value && conf.delayOff && conf.delayOff > 0) {
+    this.api = api;
+    this.accessories = [];
+
+    this.api.on('didFinishLaunching', () => {
+      this.log('🔌 MultipleSwitchPlatform başladıldı.');
+      this.setupAccessories();
+    });
+  }
+
+  setupAccessories() {
+    const switches = this.config.switches || [];
+    const behavior = this.config.switchBehavior || 'independent';
+    const name = this.config.name || 'Multiple Switch Panel';
+
+    const uuid = UUIDGen.generate(name);
+    const accessory = new this.api.platformAccessory(name, uuid);
+
+    accessory.context.switchStates = {};
+    accessory.context.switchServices = {};
+    accessory.context.switchBehavior = behavior;
+
+    switches.forEach((sw, index) => {
+      const id = `switch_${index}`;
+      const service = this.createSwitchService(accessory, sw, id);
+
+      accessory.addService(service);
+      accessory.context.switchStates[id] = sw.defaultState || false;
+      accessory.context.switchServices[id] = service;
+    });
+
+    this.api.registerPlatformAccessories(
+      'homebridge-multiple-switch',
+      'MultipleSwitchPlatform',
+      [accessory]
+    );
+    this.accessories.push(accessory);
+  }
+
+  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];
+      })
+      .onSet((value) => {
+        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);
+            }
+          });
+        }
+
+        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(() => {
-              conf.state = false;
-              service.getCharacteristic(Characteristic.On).updateValue(false);
-              this.log(`"${switchName}" auto turn off tətbiq olundu`);
-            }, conf.delayOff); // saniyəni ms-ə çeviririk
+              accessory.context.switchStates[id] = false;
+              service.updateCharacteristic(Characteristic.On, false);
+              this.log(`[${sw.name}] auto-off after ${sw.delayOff}ms`);
+            }, sw.delayOff);
           }
+        }
+      });
 
-          callback();
-        });
+    return service;
+  }
 
-      this.services.push(service);
-    });
+  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;
+    }
   }
 
-  getServices() {
-    return this.services;
+  configureAccessory(accessory) {
+    this.accessories.push(accessory);
   }
-}
+}

package/package.json

@@ -1,12 +1,25 @@
 {
   "name": "homebridge-multiple-switch",
-  "version": "1.1.3",
-  "description": "Multiple switch accessory for Homebridge",
+  "version": "1.1.5",
+  "description": "Multiple switch platform for Homebridge",
+  "homepage": "https://github.com/azadaydinli/homebridge-multiple-switch",
   "main": "index.js",
   "author": "Azad Aydınlı",
   "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/azadaydinli/homebridge-multiple-switch/issues"
+  },
   "keywords": [
-    "homebridge-plugin"
+    "homebridge-plugin",
+    "homebridge",
+    "homekit",
+    "switch",
+    "outlet",
+    "lightbulb",
+    "fan",
+    "dummy",
+    "multiple",
+    "platform"
   ],
   "repository": {
     "type": "git",
@@ -16,4 +29,4 @@
     "node": ">=14.17.0",
     "homebridge": ">=1.3.0"
   }
-}
+}