homebridge-boiler-ai 1.0.0

package/README.md

@@ -0,0 +1,199 @@
+# Homebridge Boiler AI
+
+AI-powered hot water controller for Homebridge. Once configured, it runs fully autonomously — checking weather, estimating your tank temperature, and turning the boiler on/off as needed. No daily interaction required.
+
+The AI makes sure you have hot water when you need it — using solar heating when possible and only running the electric heater when necessary.
+
+Works with [Switcher](#switcher), [Shelly](#shelly), [Tasmota](#tasmota), and [any HTTP-controllable plug](#other-smart-plugs).
+
+## Setup (5 minutes)
+
+Install the plugin from the Homebridge UI: search for **homebridge-boiler-ai** and click install.
+
+Then configure in the plugin settings (or paste into `config.json`):
+
+**Minimal config — Switcher:**
+
+```jsonc
+{
+  "platform": "BoilerAI",
+  "name": "Boiler AI",
+
+  // ── Required ──────────────────────────────────
+  "geminiApiKey": "YOUR_GEMINI_API_KEY",   // get from https://aistudio.google.com/apikey
+  "location": "Tel Aviv",                  // your city (verify: wttr.in/YourCity)
+  "timezone": "Asia/Jerusalem",            // your timezone
+  "switcher": {
+    "deviceId": "Switcher_Touch_386C"      // name from Switcher app, IP, or hex ID
+  },
+  "usage": [
+    { "time": "07:00", "label": "Morning shower", "liters": 60, "temp": 45 },
+    { "time": "20:00", "label": "Evening shower", "liters": 100, "temp": 50 }
+  ],
+
+  // ── Optional ──────────────────────────────────
+  // "tank": { "liters": 120, "heaterKw": 2.5 },  // auto-detected from location
+  // "xaiApiKey": "",                      // alternative to Gemini
+  // "switcher.token": "",                 // only if you get auth errors
+  // "maxDurationMinutes": 90              // safety cap per cycle
+}
+```
+
+**Minimal config — Shelly / HTTP plug:**
+
+```jsonc
+{
+  "platform": "BoilerAI",
+  "name": "Boiler AI",
+
+  // ── Required ──────────────────────────────────
+  "geminiApiKey": "YOUR_GEMINI_API_KEY",
+  "location": "Tel Aviv",
+  "timezone": "Asia/Jerusalem",
+  "boilerPlug": {
+    "onUrl": "http://192.168.1.50/relay/0?turn=on",
+    "offUrl": "http://192.168.1.50/relay/0?turn=off"
+  },
+  "usage": [
+    { "time": "07:00", "label": "Morning shower", "liters": 60, "temp": 45 },
+    { "time": "20:00", "label": "Evening shower", "liters": 100, "temp": 50 }
+  ]
+}
+```
+
+---
+
+### 1. AI API Key
+
+Get an API key from [Google AI Studio](https://aistudio.google.com/apikey) — sign in, click "Create API Key", and paste it into the **Gemini API Key** field.
+
+The plugin uses Gemini Flash-Lite which has a free tier (1,000 requests/day — the plugin uses ~5-10/day). New Google accounts may need to set up billing first, but usage within the free limits is not charged. See [Gemini API pricing](https://ai.google.dev/gemini-api/docs/pricing) for current details.
+
+Alternatively, you can use [xAI Grok](https://console.x.ai/) (paid, but faster responses).
+
+### 2. Location
+
+Enter your city name in the **Location** field. To verify it works, open `wttr.in/YourCity` in your browser (e.g. [wttr.in/Tel+Aviv](https://wttr.in/Tel+Aviv)) — if it shows the right weather, use that city name.
+
+Enter your timezone in the **Timezone** field. To find it, run `timedatectl | grep "Time zone"`.
+
+### 3. Smart Plug
+
+Tell the plugin how to turn your boiler on and off. Pick your plug type:
+
+#### Switcher
+
+Native support — the plugin finds and controls the Switcher directly on your local network. No URLs needed, no extra plugins.
+
+Enter your device name (as it appears in the Switcher app), IP address, or device ID — any of these work:
+
+```json
+"switcher": {
+  "deviceId": "Switcher_Touch_386C"
+}
+```
+
+If you get auth errors in the logs, your model may need a token — get it from https://switcher.co.il/GetKey/ and add `"token": "your-token"`.
+
+> **Note:** If you have `homebridge-switcher-platform` installed, disable or remove it first — two plugins can't control the same Switcher device simultaneously.
+
+#### Shelly
+
+```json
+"boilerPlug": {
+  "onUrl": "http://192.168.1.50/relay/0?turn=on",
+  "offUrl": "http://192.168.1.50/relay/0?turn=off"
+}
+```
+
+For Gen2+ (Plus/Pro series):
+```json
+"boilerPlug": {
+  "onUrl": "http://192.168.1.50/rpc/Switch.Set?id=0&on=true",
+  "offUrl": "http://192.168.1.50/rpc/Switch.Set?id=0&on=false"
+}
+```
+
+#### Tasmota
+
+```json
+"boilerPlug": {
+  "onUrl": "http://192.168.1.51/cm?cmnd=Power%20On",
+  "offUrl": "http://192.168.1.51/cm?cmnd=Power%20Off"
+}
+```
+
+#### Other smart plugs
+
+Any plug with an HTTP on/off URL works. For plugs that need POST requests or auth headers:
+
+```json
+"boilerPlug": {
+  "onUrl": "http://192.168.1.53/api/switch/on",
+  "offUrl": "http://192.168.1.53/api/switch/off",
+  "method": "POST",
+  "headers": "{\"Authorization\": \"Bearer TOKEN\", \"Content-Type\": \"application/json\"}",
+  "body": "{\"device\": \"boiler\"}"
+}
+```
+
+> **Note:** Use either `switcher` or `boilerPlug` — not both.
+
+### 4. Hot Water Schedule
+
+Add the times your household needs hot water:
+
+```json
+"usage": [
+  { "time": "07:00", "label": "Morning shower", "liters": 60, "temp": 45 },
+  { "time": "18:30", "label": "Kid bath", "liters": 50, "temp": 45 },
+  { "time": "22:00", "label": "Evening shower", "liters": 100, "temp": 50 }
+]
+```
+
+The plugin checks automatically ~1 hour before each event and only heats if needed. On sunny days, the sun does the work and the electric heater stays off.
+
+### Tank (auto-detected)
+
+On first startup, the plugin detects the standard tank specs for your location automatically. If your tank is different, override by adding the `tank` section to your config:
+
+```json
+"tank": {
+  "liters": 120,
+  "heaterKw": 2.5,
+  "solar": true
+}
+```
+
+Set `"solar": false` if your tank is electric-only (no rooftop solar panel).
+
+## How it works
+
+**The plugin is fully autonomous.** Once configured, it runs on its own. Before each time you need hot water, it:
+
+1. Fetches weather and sunrise/sunset for your location
+2. Estimates the tank temperature from heating history and solar gain
+3. Asks the AI whether heating is needed and for how long
+4. Turns the boiler on/off via your smart plug
+
+This runs in the background as long as Homebridge is running — no interaction needed.
+
+**Important:** There is no physical temperature sensor. The tank temperature is estimated based on weather conditions, solar gain, heating history, and standby heat loss. The AI uses this estimate to make decisions. It works well in practice, but it's a model — not a measurement.
+
+On the first day after installation, the system has no heating history, so the initial temperature estimate may be off. After the first heating cycle it calibrates itself and becomes more accurate over time.
+
+### The HomeKit switch
+
+The boiler appears as a switch in the Home app, but it does **not** enable/disable the system. Think of it as a button:
+
+- **Tap ON** = "check now" — manually triggers one AI decision. The switch turns itself back off afterward.
+- **Tap OFF** = emergency stop — immediately turns off the boiler if it's heating.
+
+The automatic schedule runs regardless. You never need to touch the switch — it's there for manual overrides only.
+
+## Safety
+
+- **Max duration cap** — no single cycle exceeds 90 minutes (configurable)
+- **Watchdog timer** — force-stops 5 minutes after max, no matter what
+- **Crash recovery** — sends OFF on Homebridge restart if boiler was left on
+- **Retry logic** — 3 attempts for every on/off command, with emergency double-off on failure

package/config.schema.json

@@ -0,0 +1,184 @@
+{
+  "pluginAlias": "BoilerAI",
+  "pluginType": "platform",
+  "singular": true,
+  "headerDisplay": "AI-powered solar hot water tank controller. Uses Gemini or Grok to decide when to run the electric heater, optimizing for minimal electricity by leveraging solar heating.",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Plugin Name",
+        "type": "string",
+        "default": "Boiler AI"
+      },
+      "location": {
+        "title": "Location",
+        "type": "string",
+        "description": "City name for weather (test with: curl wttr.in/YourCity)",
+        "placeholder": "Tel Aviv",
+        "required": true
+      },
+      "timezone": {
+        "title": "Timezone",
+        "type": "string",
+        "description": "IANA timezone (find yours: timedatectl | grep 'Time zone')",
+        "placeholder": "Asia/Jerusalem",
+        "required": true
+      },
+      "geminiApiKey": {
+        "title": "Gemini API Key",
+        "type": "string",
+        "description": "Google Gemini API key (free tier available at aistudio.google.com)",
+        "x-schema-form": { "type": "password" }
+      },
+      "xaiApiKey": {
+        "title": "xAI (Grok) API Key",
+        "type": "string",
+        "description": "Optional. If set, Grok is preferred over Gemini",
+        "x-schema-form": { "type": "password" }
+      },
+      "tank": {
+        "title": "Tank",
+        "type": "object",
+        "properties": {
+          "liters": {
+            "title": "Capacity (liters)",
+            "type": "integer",
+            "default": 120,
+            "minimum": 20,
+            "maximum": 500,
+            "required": true
+          },
+          "heaterKw": {
+            "title": "Heater Power (kW)",
+            "type": "number",
+            "default": 2.5,
+            "minimum": 0.5,
+            "maximum": 10,
+            "required": true
+          },
+          "solar": {
+            "title": "Has Solar Collector",
+            "type": "boolean",
+            "default": true,
+            "description": "Disable for electric-only tanks"
+          }
+        }
+      },
+      "boilerPlug": {
+        "title": "Boiler Smart Plug",
+        "type": "object",
+        "properties": {
+          "onUrl": {
+            "title": "ON URL",
+            "type": "string",
+            "description": "HTTP URL to turn boiler on",
+            "required": true
+          },
+          "offUrl": {
+            "title": "OFF URL",
+            "type": "string",
+            "description": "HTTP URL to turn boiler off",
+            "required": true
+          },
+          "method": {
+            "title": "HTTP Method",
+            "type": "string",
+            "default": "GET",
+            "oneOf": [
+              { "title": "GET", "enum": ["GET"] },
+              { "title": "POST", "enum": ["POST"] }
+            ]
+          },
+          "headers": {
+            "title": "HTTP Headers (JSON)",
+            "type": "string",
+            "description": "Optional JSON object, e.g. {\"Authorization\": \"Bearer token\"}"
+          },
+          "body": {
+            "title": "Request Body",
+            "type": "string",
+            "description": "Optional body for POST requests"
+          }
+        }
+      },
+      "switcher": {
+        "title": "Switcher (Israeli boiler plug)",
+        "type": "object",
+        "description": "If configured, the plugin controls the boiler via Switcher directly (no HTTP URLs needed). Leave empty to use HTTP smart plug instead.",
+        "properties": {
+          "deviceId": {
+            "title": "Device ID",
+            "type": "string",
+            "description": "Device name (as shown in Switcher app), IP address, or hex device ID"
+          },
+          "deviceIp": {
+            "title": "Device IP (optional)",
+            "type": "string",
+            "description": "Optional — device is auto-discovered on your network. Set only if discovery fails."
+          },
+          "token": {
+            "title": "Token (optional)",
+            "type": "string",
+            "description": "Only if needed — get it from https://switcher.co.il/GetKey/",
+            "x-schema-form": { "type": "password" }
+          }
+        }
+      },
+      "usage": {
+        "title": "Hot Water Usage",
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "time": {
+              "title": "Time (HH:MM)",
+              "type": "string",
+              "pattern": "^\\d{2}:\\d{2}$",
+              "required": true
+            },
+            "label": {
+              "title": "Label",
+              "type": "string",
+              "required": true
+            },
+            "liters": {
+              "title": "Liters",
+              "type": "integer",
+              "minimum": 5,
+              "required": true
+            },
+            "temp": {
+              "title": "Temperature (°C)",
+              "type": "number",
+              "minimum": 30,
+              "maximum": 65,
+              "required": true
+            }
+          }
+        },
+        "default": [
+          { "time": "06:00", "label": "Morning wash", "liters": 30, "temp": 38 },
+          { "time": "18:30", "label": "Kid bath", "liters": 50, "temp": 45 },
+          { "time": "22:00", "label": "Showers", "liters": 120, "temp": 50 }
+        ]
+      },
+      "maxDurationMinutes": {
+        "title": "Max Heating Duration (minutes)",
+        "type": "integer",
+        "default": 90,
+        "minimum": 10,
+        "maximum": 120,
+        "description": "Safety cap per heating cycle"
+      },
+      "aiTemperature": {
+        "title": "AI Temperature",
+        "type": "number",
+        "default": 0.3,
+        "minimum": 0,
+        "maximum": 1,
+        "description": "Lower = more conservative decisions"
+      }
+    }
+  }
+}

package/dist/ai.d.ts

@@ -0,0 +1,7 @@
+import { Logger } from 'homebridge';
+import * as http from 'http';
+export declare function callAI(prompt: string, timeoutSecs: number, xaiApiKey?: string, geminiApiKey?: string, temperature?: number, log?: Logger): Promise<string>;
+declare function httpRequest(url: string, options: http.RequestOptions & {
+    timeout?: number;
+}, body?: string): Promise<string>;
+export { httpRequest };

package/dist/ai.js

@@ -0,0 +1,116 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callAI = callAI;
+exports.httpRequest = httpRequest;
+const https = __importStar(require("https"));
+const http = __importStar(require("http"));
+async function callAI(prompt, timeoutSecs, xaiApiKey, geminiApiKey, temperature = 0.3, log) {
+    if (xaiApiKey) {
+        return callOpenAICompatible('https://api.x.ai/v1/chat/completions', xaiApiKey, 'grok-3-mini-fast', prompt, timeoutSecs, temperature);
+    }
+    if (geminiApiKey) {
+        return callGeminiREST(geminiApiKey, 'gemini-2.5-flash-lite', prompt, timeoutSecs);
+    }
+    throw new Error('No AI API key set (need geminiApiKey or xaiApiKey)');
+}
+function callOpenAICompatible(endpoint, apiKey, model, prompt, timeoutSecs, temperature) {
+    const body = JSON.stringify({
+        model,
+        messages: [{ role: 'user', content: prompt }],
+        temperature,
+    });
+    return httpRequest(endpoint, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${apiKey}`,
+        },
+        timeout: timeoutSecs * 1000,
+    }, body).then(data => {
+        const result = JSON.parse(data);
+        if (!result.choices?.length)
+            throw new Error('Empty AI response');
+        return result.choices[0].message.content;
+    });
+}
+function callGeminiREST(apiKey, model, prompt, timeoutSecs) {
+    const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent`;
+    const body = JSON.stringify({
+        contents: [{ parts: [{ text: prompt }] }],
+    });
+    return httpRequest(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'x-goog-api-key': apiKey,
+        },
+        timeout: timeoutSecs * 1000,
+    }, body).then(data => {
+        const result = JSON.parse(data);
+        if (!result.candidates?.[0]?.content?.parts?.[0]?.text) {
+            throw new Error('Empty AI response');
+        }
+        return result.candidates[0].content.parts[0].text;
+    });
+}
+function httpRequest(url, options, body) {
+    return new Promise((resolve, reject) => {
+        const lib = url.startsWith('https') ? https : http;
+        const req = lib.request(url, options, (res) => {
+            let data = '';
+            res.on('data', chunk => data += chunk);
+            res.on('end', () => {
+                if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                    resolve(data);
+                }
+                else {
+                    reject(new Error(`API error ${res.statusCode}: ${data.slice(0, 200)}`));
+                }
+            });
+        });
+        req.on('error', reject);
+        if (options.timeout) {
+            req.setTimeout(options.timeout, () => {
+                req.destroy();
+                reject(new Error('Request timeout'));
+            });
+        }
+        if (body)
+            req.write(body);
+        req.end();
+    });
+}
+//# sourceMappingURL=ai.js.map

package/dist/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"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"}

package/dist/boiler.d.ts

@@ -0,0 +1,3 @@
+import { Logger } from 'homebridge';
+import { BoilerPlugConfig } from './settings';
+export declare function sendWebhook(on: boolean, plug: BoilerPlugConfig, log: Logger): Promise<void>;

package/dist/boiler.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendWebhook = sendWebhook;
+const ai_1 = require("./ai");
+const WEBHOOK_RETRIES = 3;
+const WEBHOOK_TIMEOUT = 5000;
+const WEBHOOK_RETRY_DELAY = 2000;
+async function sendWebhook(on, plug, log) {
+    const url = on ? plug.onUrl : plug.offUrl;
+    const method = (plug.method || 'GET').toUpperCase();
+    let headers = {};
+    if (plug.headers) {
+        try {
+            headers = JSON.parse(plug.headers);
+        }
+        catch {
+            log.warn('WEBHOOK: failed to parse headers JSON');
+        }
+    }
+    let lastErr = null;
+    for (let attempt = 1; attempt <= WEBHOOK_RETRIES; attempt++) {
+        try {
+            await (0, ai_1.httpRequest)(url, {
+                method,
+                headers: Object.keys(headers).length > 0 ? headers : undefined,
+                timeout: WEBHOOK_TIMEOUT,
+            }, plug.body || undefined);
+            log.info(`WEBHOOK: boiler ${on ? 'true' : 'false'} (attempt ${attempt})`);
+            return;
+        }
+        catch (err) {
+            lastErr = err;
+            log.warn(`WEBHOOK: attempt ${attempt} failed: ${lastErr.message}`);
+            if (attempt < WEBHOOK_RETRIES) {
+                await sleep(WEBHOOK_RETRY_DELAY);
+            }
+        }
+    }
+    throw new Error(`Webhook failed after ${WEBHOOK_RETRIES} attempts: ${lastErr?.message}`);
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=boiler.js.map

package/dist/boiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boiler.js","sourceRoot":"","sources":["../src/boiler.ts"],"names":[],"mappings":";;AAQA,kCAkCC;AAxCD,6BAAmC;AAEnC,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAE1B,KAAK,UAAU,WAAW,CAAC,EAAW,EAAE,IAAsB,EAAE,GAAW;IAChF,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1C,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAEpD,IAAI,OAAO,GAA2B,EAAE,CAAC;IACzC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,IAAI,OAAO,GAAiB,IAAI,CAAC;IACjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,eAAe,EAAE,OAAO,EAAE,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,IAAA,gBAAW,EAAC,GAAG,EAAE;gBACrB,MAAM;gBACN,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBAC9D,OAAO,EAAE,eAAe;aACzB,EAAE,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC;YAE3B,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,aAAa,OAAO,GAAG,CAAC,CAAC;YAC1E,OAAO;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,GAAG,GAAY,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,oBAAoB,OAAO,YAAY,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YACnE,IAAI,OAAO,GAAG,eAAe,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,wBAAwB,eAAe,cAAc,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/boilerAccessory.d.ts

@@ -0,0 +1,12 @@
+import { PlatformAccessory, CharacteristicValue, Logger } from 'homebridge';
+import { BoilerAIPlatform } from './platform';
+export declare class BoilerAccessory {
+    private readonly platform;
+    private readonly accessory;
+    private readonly log;
+    private service;
+    constructor(platform: BoilerAIPlatform, accessory: PlatformAccessory, log: Logger);
+    getOn(): Promise<CharacteristicValue>;
+    setOn(value: CharacteristicValue): Promise<void>;
+    updateState(on: boolean): void;
+}

package/dist/boilerAccessory.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoilerAccessory = void 0;
+class BoilerAccessory {
+    constructor(platform, accessory, log) {
+        this.platform = platform;
+        this.accessory = accessory;
+        this.log = log;
+        this.accessory.getService(this.platform.Service.AccessoryInformation)
+            .setCharacteristic(this.platform.Characteristic.Manufacturer, 'Boiler AI')
+            .setCharacteristic(this.platform.Characteristic.Model, 'Solar Hot Water Controller')
+            .setCharacteristic(this.platform.Characteristic.SerialNumber, 'BOILER-AI-001');
+        this.service = this.accessory.getService(this.platform.Service.Switch)
+            || this.accessory.addService(this.platform.Service.Switch, 'Boiler AI');
+        this.service.getCharacteristic(this.platform.Characteristic.On)
+            .onGet(this.getOn.bind(this))
+            .onSet(this.setOn.bind(this));
+    }
+    async getOn() {
+        return this.platform.isBoilerOn();
+    }
+    async setOn(value) {
+        if (value) {
+            this.log.info('HomeKit: triggering AI decision cycle');
+            this.platform.triggerDecisionCycle('homekit');
+        }
+        else {
+            this.log.info('HomeKit: emergency stop');
+            await this.platform.stopBoiler();
+        }
+    }
+    updateState(on) {
+        this.service.updateCharacteristic(this.platform.Characteristic.On, on);
+    }
+}
+exports.BoilerAccessory = BoilerAccessory;
+//# sourceMappingURL=boilerAccessory.js.map

package/dist/boilerAccessory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boilerAccessory.js","sourceRoot":"","sources":["../src/boilerAccessory.ts"],"names":[],"mappings":";;;AAGA,MAAa,eAAe;IAG1B,YACmB,QAA0B,EAC1B,SAA4B,EAC5B,GAAW;QAFX,aAAQ,GAAR,QAAQ,CAAkB;QAC1B,cAAS,GAAT,SAAS,CAAmB;QAC5B,QAAG,GAAH,GAAG,CAAQ;QAE5B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,oBAAoB,CAAE;aACnE,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,YAAY,EAAE,WAAW,CAAC;aACzE,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,4BAA4B,CAAC;aACnF,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;QAEjF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;eACjE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAE1E,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;aAC5D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAA0B;QACpC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YACvD,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;YACzC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAED,WAAW,CAAC,EAAW;QACrB,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;CACF;AAtCD,0CAsCC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { API } from 'homebridge';
+declare const _default: (api: API) => void;
+export default _default;

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const settings_1 = require("./settings");
+const platform_1 = require("./platform");
+exports.default = (api) => {
+    api.registerPlatform(settings_1.PLUGIN_NAME, settings_1.PLATFORM_NAME, platform_1.BoilerAIPlatform);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AACA,yCAAwD;AACxD,yCAA8C;AAE9C,kBAAe,CAAC,GAAQ,EAAQ,EAAE;IAChC,GAAG,CAAC,gBAAgB,CAAC,sBAAW,EAAE,wBAAa,EAAE,2BAAgB,CAAC,CAAC;AACrE,CAAC,CAAC"}