homebridge-changedetection 0.0.0-stage → 0.1.4

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Alexxanddr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -1,3 +1,161 @@
-# Temporary Holding Version
+# homebridge-changedetection
+
+[![CI](https://github.com/Alexxanddr/homebridge-changedetection/actions/workflows/ci.yml/badge.svg)](https://github.com/Alexxanddr/homebridge-changedetection/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/homebridge-changedetection)](https://www.npmjs.com/package/homebridge-changedetection)
+
+A Homebridge dynamic platform plugin that turns
+[changedetection.io](https://github.com/dgtlmoon/changedetection.io) webhook notifications into
+HomeKit motion sensor events.
+
+Each configured watch appears as a separate motion sensor in Apple Home. Use that sensor as the
+trigger for automations that control lights, scenes, switches, notifications, and other accessories.
+
+## Features
+
+- Push-based: events arrive immediately through a webhook; no polling or API key is required.
+- One independent HomeKit motion sensor per changedetection.io watch.
+- Works with self-hosted and hosted changedetection.io instances.
+- Shared-secret authentication with constant-time comparison.
+- Built-in Homebridge settings UI schema.
+- No cloud service, analytics, or product-specific infrastructure.
+
+## Requirements
+
+- Homebridge 1.8 or 2.x
+- Node.js 22.10 or 24.x
+- Network access from changedetection.io to the Homebridge webhook port
+
+## Installation
+
+Search for **ChangeDetection** in Homebridge UI, or install it from a terminal:
+
+```shell
+npm install --global homebridge-changedetection
+```
+
+The package will appear in Homebridge's plugin search after it has been published to npm. A GitHub
+repository by itself is not enough for registry discovery.
+
+## Homebridge configuration
+
+The recommended method is Homebridge UI. Add the platform, generate a random token of at least 16
+characters, and create one sensor for each watch.
+
+Equivalent `config.json` example:
+
+```json
+{
+  "platform": "ChangeDetection",
+  "name": "ChangeDetection",
+  "port": 3210,
+  "bindAddress": "0.0.0.0",
+  "token": "replace-with-a-long-random-secret",
+  "resetAfterSeconds": 10,
+  "sensors": [
+    {
+      "id": "product-stock",
+      "name": "Product stock changed"
+    },
+    {
+      "id": "release-page",
+      "name": "New software release"
+    }
+  ]
+}
+```
+
+Sensor IDs are user-defined stable identifiers. They do not need to match changedetection.io watch
+UUIDs, although using a watch UUID is supported.
+
+## Configure changedetection.io
+
+For each watch, open **Edit > Notifications** and add a POST notification URL that targets the
+matching sensor ID:
+
+```text
+post://HOMEbridge_HOST:3210/webhook/product-stock?+x-changedetection-token=YOUR_TOKEN
+```
+
+Use `posts://` when the webhook endpoint is behind HTTPS. The `+` prefix tells Apprise to send the
+query parameter as an HTTP header rather than in the request URL.
+
+Set the notification body to a small valid JSON document:
+
+```json
+{
+  "title": {{ watch_title | tojson }},
+  "url": {{ watch_url | tojson }},
+  "watch_uuid": {{ watch_uuid | tojson }}
+}
+```
+
+The plugin currently ignores the body; it is included for useful logging and future compatibility.
+The sensor is selected exclusively by the URL path.
+
+Use changedetection.io's **Send test notification** action, then check the Homebridge log and Apple
+Home. The sensor should become active and return to inactive after `resetAfterSeconds`.
+
+### Test with curl
+
+```shell
+curl --request POST \
+  --header 'X-ChangeDetection-Token: YOUR_TOKEN' \
+  --header 'Content-Type: application/json' \
+  --data '{}' \
+  http://HOMEbridge_HOST:3210/webhook/product-stock
+```
+
+Health checks are available without authentication:
+
+```shell
+curl http://HOMEbridge_HOST:3210/health
+```
+
+## Containers and reverse proxies
+
+Expose TCP port `3210` from the Homebridge container, or route it only on a trusted internal network.
+The webhook does not need to be publicly accessible when changedetection.io and Homebridge can
+communicate locally.
+
+If a reverse proxy terminates TLS, forward POST requests to the configured webhook port and retain
+the `X-ChangeDetection-Token` header. Do not publish the endpoint without authentication.
+
+## Apple Home automations
+
+Create an automation using the sensor event **Detects Motion**. For example:
+
+1. When `Product stock changed` detects motion;
+2. turn on a light or activate a scene;
+3. optionally turn it off after a delay.
+
+The plugin resets the sensor automatically so a later website change can trigger the automation
+again.
+
+## Troubleshooting
+
+- **Plugin is not configured**: add at least one sensor and a token containing 16 or more characters.
+- **401 Unauthorized**: the `X-ChangeDetection-Token` header does not match the configured token.
+- **404 Unknown sensor**: the final URL segment must exactly match a configured sensor ID.
+- **Connection refused**: expose the configured port and verify routing between the two services.
+- **No Apple Home automation**: confirm the sensor changes state in the Homebridge log first.
+
+## Development
+
+```shell
+npm install
+npm run check
+npm link
+homebridge -D
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the contribution workflow and
+[docs/PUBLISHING.md](docs/PUBLISHING.md) for the release process.
+
+## Security
+
+See [SECURITY.md](SECURITY.md). Never include a real webhook token in issues, screenshots, or logs.
+
+## License
+
+[MIT](LICENSE)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/config.schema.json

@@ -0,0 +1,92 @@
+{
+  "pluginAlias": "ChangeDetection",
+  "pluginType": "platform",
+  "singular": true,
+  "strictValidation": true,
+  "schema": {
+    "type": "object",
+    "required": ["name", "token", "sensors"],
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "default": "ChangeDetection",
+        "minLength": 1
+      },
+      "port": {
+        "title": "Webhook port",
+        "type": "integer",
+        "default": 3210,
+        "minimum": 1,
+        "maximum": 65535
+      },
+      "bindAddress": {
+        "title": "Bind address",
+        "type": "string",
+        "default": "0.0.0.0",
+        "description": "Use 0.0.0.0 when changedetection.io runs on another host or in another container."
+      },
+      "token": {
+        "title": "Webhook token",
+        "type": "string",
+        "minLength": 16,
+        "format": "password",
+        "description": "A random shared secret sent in the X-ChangeDetection-Token header."
+      },
+      "resetAfterSeconds": {
+        "title": "Reset after",
+        "type": "integer",
+        "default": 10,
+        "minimum": 1,
+        "maximum": 3600,
+        "description": "Seconds before a triggered motion sensor returns to inactive."
+      },
+      "sensors": {
+        "title": "Watch sensors",
+        "type": "array",
+        "minItems": 1,
+        "uniqueItems": true,
+        "items": {
+          "type": "object",
+          "required": ["id", "name"],
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "title": "Webhook ID",
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "pattern": "^[A-Za-z0-9._~-]+$",
+              "description": "A stable ID used in /webhook/<id>, for example product-stock."
+            },
+            "name": {
+              "title": "HomeKit name",
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 64
+            }
+          }
+        }
+      }
+    }
+  },
+  "layout": [
+    "name",
+    {
+      "key": "sensors",
+      "type": "array",
+      "name": "Watch sensors",
+      "orderable": true,
+      "buttonText": "Add sensor"
+    },
+    {
+      "type": "fieldset",
+      "title": "Webhook server",
+      "expandable": true,
+      "expanded": false,
+      "items": ["port", "bindAddress", "token", "resetAfterSeconds"]
+    }
+  ]
+}
+

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,6 @@
+import { ChangeDetectionPlatform } from './platform.js';
+import { PLATFORM_NAME, PLUGIN_NAME } from './settings.js';
+export default (api) => {
+    api.registerPlatform(PLUGIN_NAME, PLATFORM_NAME, ChangeDetectionPlatform);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3D,eAAe,CAAC,GAAQ,EAAQ,EAAE;IAChC,GAAG,CAAC,gBAAgB,CAAC,WAAW,EAAE,aAAa,EAAE,uBAAuB,CAAC,CAAC;AAC5E,CAAC,CAAC"}

package/dist/platform.d.ts

@@ -0,0 +1,16 @@
+import { type API, type DynamicPlatformPlugin, type Logging, type PlatformAccessory } from 'homebridge';
+import type { ChangeDetectionConfig } from './types.js';
+export declare class ChangeDetectionPlatform implements DynamicPlatformPlugin {
+    private readonly log;
+    private readonly config;
+    private readonly api;
+    private readonly cachedAccessories;
+    private readonly sensors;
+    private server?;
+    constructor(log: Logging, config: ChangeDetectionConfig, api: API);
+    configureAccessory(accessory: PlatformAccessory): void;
+    private start;
+    private stop;
+    private validSensors;
+    private integerInRange;
+}

package/dist/platform.js

@@ -0,0 +1,105 @@
+import { ChangeSensor } from './sensor.js';
+import { DEFAULT_BIND_ADDRESS, DEFAULT_PORT, DEFAULT_RESET_SECONDS, PLATFORM_NAME, PLUGIN_NAME, } from './settings.js';
+import { WebhookServer } from './webhook-server.js';
+export class ChangeDetectionPlatform {
+    log;
+    config;
+    api;
+    cachedAccessories = new Map();
+    sensors = new Map();
+    server;
+    constructor(log, config, api) {
+        this.log = log;
+        this.config = config;
+        this.api = api;
+        if (!config) {
+            return;
+        }
+        api.on("didFinishLaunching" /* APIEvent.DID_FINISH_LAUNCHING */, () => this.start());
+        api.on("shutdown" /* APIEvent.SHUTDOWN */, () => this.stop());
+    }
+    configureAccessory(accessory) {
+        this.cachedAccessories.set(accessory.UUID, accessory);
+    }
+    start() {
+        const token = this.config.token?.trim();
+        const sensorConfigs = this.validSensors(this.config.sensors);
+        if (!token || token.length < 16 || sensorConfigs.length === 0) {
+            this.log.error('Plugin is not configured: add a token of at least 16 characters and one sensor.');
+            return;
+        }
+        const resetAfterSeconds = this.integerInRange(this.config.resetAfterSeconds, 1, 3600, DEFAULT_RESET_SECONDS);
+        const activeUuids = new Set();
+        for (const sensorConfig of sensorConfigs) {
+            const uuid = this.api.hap.uuid.generate(sensorConfig.id);
+            activeUuids.add(uuid);
+            const accessory = this.cachedAccessories.get(uuid)
+                ?? new this.api.platformAccessory(sensorConfig.name, uuid);
+            accessory.displayName = sensorConfig.name;
+            accessory.context.sensorId = sensorConfig.id;
+            accessory.getService(this.api.hap.Service.AccessoryInformation)
+                ?.setCharacteristic(this.api.hap.Characteristic.Manufacturer, 'ChangeDetection')
+                .setCharacteristic(this.api.hap.Characteristic.Model, 'Webhook Motion Sensor')
+                .setCharacteristic(this.api.hap.Characteristic.SerialNumber, sensorConfig.id);
+            const motionService = accessory.getService(this.api.hap.Service.MotionSensor)
+                ?? accessory.addService(this.api.hap.Service.MotionSensor, 'Change detected');
+            motionService.setCharacteristic(this.api.hap.Characteristic.Name, sensorConfig.name);
+            if (!this.cachedAccessories.has(uuid)) {
+                this.api.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [accessory]);
+                this.cachedAccessories.set(uuid, accessory);
+            }
+            this.sensors.set(sensorConfig.id, new ChangeSensor(accessory, motionService, this.log, resetAfterSeconds));
+        }
+        const staleAccessories = [...this.cachedAccessories.values()]
+            .filter(accessory => !activeUuids.has(accessory.UUID));
+        if (staleAccessories.length > 0) {
+            this.api.unregisterPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, staleAccessories);
+        }
+        const port = this.integerInRange(this.config.port, 1, 65535, DEFAULT_PORT);
+        const bindAddress = this.config.bindAddress?.trim() || DEFAULT_BIND_ADDRESS;
+        this.server = new WebhookServer({
+            bindAddress,
+            port,
+            token,
+            onTrigger: id => {
+                const sensor = this.sensors.get(id);
+                sensor?.trigger();
+                return Boolean(sensor);
+            },
+        });
+        void this.server.start()
+            .then(() => this.log.info('Webhook server listening on %s:%d', bindAddress, port))
+            .catch(error => this.log.error('Could not start webhook server: %s', String(error)));
+    }
+    stop() {
+        for (const sensor of this.sensors.values()) {
+            sensor.stop();
+        }
+        void this.server?.stop()
+            .catch(error => this.log.error('Could not stop webhook server: %s', String(error)));
+    }
+    validSensors(value) {
+        if (!Array.isArray(value)) {
+            return [];
+        }
+        const result = [];
+        const ids = new Set();
+        for (const sensor of value) {
+            const id = sensor?.id?.trim();
+            const name = sensor?.name?.trim();
+            if (!id || !name || !/^[A-Za-z0-9._~-]{1,128}$/.test(id) || ids.has(id)) {
+                this.log.warn('Ignoring invalid or duplicate sensor configuration.');
+                continue;
+            }
+            ids.add(id);
+            result.push({ id, name });
+        }
+        return result;
+    }
+    integerInRange(value, min, max, fallback) {
+        return Number.isInteger(value) && value !== undefined && value >= min && value <= max
+            ? value
+            : fallback;
+    }
+}
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,OAAO,uBAAuB;IAMf;IACA;IACA;IAPF,iBAAiB,GAAG,IAAI,GAAG,EAA6B,CAAC;IACzD,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IACnD,MAAM,CAAiB;IAE/B,YACmB,GAAY,EACZ,MAA6B,EAC7B,GAAQ;QAFR,QAAG,GAAH,GAAG,CAAS;QACZ,WAAM,GAAN,MAAM,CAAuB;QAC7B,QAAG,GAAH,GAAG,CAAK;QAEzB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,GAAG,CAAC,EAAE,2DAAgC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1D,GAAG,CAAC,EAAE,qCAAoB,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,kBAAkB,CAAC,SAA4B;QAC7C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IAEO,KAAK;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QACxC,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,iFAAiF,CAAC,CAAC;YAClG,OAAO;QACT,CAAC;QAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,CAC3C,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAC7B,CAAC,EACD,IAAI,EACJ,qBAAqB,CACtB,CAAC;QACF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QAEtC,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACzD,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtB,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;mBAC7C,IAAI,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAE7D,SAAS,CAAC,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC;YAC1C,SAAS,CAAC,OAAO,CAAC,QAAQ,GAAG,YAAY,CAAC,EAAE,CAAC;YAC7C,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,oBAAoB,CAAC;gBAC7D,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,iBAAiB,CAAC;iBAC/E,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,EAAE,uBAAuB,CAAC;iBAC7E,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;YAEhF,MAAM,aAAa,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC;mBACxE,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;YAChF,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;YAErF,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,GAAG,CAAC,2BAA2B,CAAC,WAAW,EAAE,aAAa,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC9E,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC9C,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,GAAG,CACd,YAAY,CAAC,EAAE,EACf,IAAI,YAAY,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CACxE,CAAC;QACJ,CAAC;QAED,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC;aAC1D,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,6BAA6B,CAAC,WAAW,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAC;QACvF,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,oBAAoB,CAAC;QAC5E,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC;YAC9B,WAAW;YACX,IAAI;YACJ,KAAK;YACL,SAAS,EAAE,EAAE,CAAC,EAAE;gBACd,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACpC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAClB,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;SACF,CAAC,CAAC;QAEH,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;aACrB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,mCAAmC,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;aACjF,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,oCAAoC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzF,CAAC;IAEO,IAAI;QACV,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,CAAC;QACD,KAAK,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE;aACrB,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,mCAAmC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IAEO,YAAY,CAAC,KAAiC;QACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QAC9B,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;YAC3B,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACxE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;gBACrE,SAAS;YACX,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,cAAc,CAAC,KAAyB,EAAE,GAAW,EAAE,GAAW,EAAE,QAAgB;QAC1F,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG;YACnF,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,QAAQ,CAAC;IACf,CAAC;CACF"}

package/dist/sensor.d.ts

@@ -0,0 +1,11 @@
+import type { Logging, PlatformAccessory, Service } from 'homebridge';
+export declare class ChangeSensor {
+    private readonly accessory;
+    private readonly motionService;
+    private readonly log;
+    private readonly resetAfterSeconds;
+    private resetTimer?;
+    constructor(accessory: PlatformAccessory, motionService: Service, log: Logging, resetAfterSeconds: number);
+    trigger(): void;
+    stop(): void;
+}

package/dist/sensor.js

@@ -0,0 +1,33 @@
+export class ChangeSensor {
+    accessory;
+    motionService;
+    log;
+    resetAfterSeconds;
+    resetTimer;
+    constructor(accessory, motionService, log, resetAfterSeconds) {
+        this.accessory = accessory;
+        this.motionService = motionService;
+        this.log = log;
+        this.resetAfterSeconds = resetAfterSeconds;
+    }
+    trigger() {
+        if (this.resetTimer) {
+            clearTimeout(this.resetTimer);
+        }
+        this.motionService.updateCharacteristic('MotionDetected', true);
+        this.log.info('Change detected for %s', this.accessory.displayName);
+        this.resetTimer = setTimeout(() => {
+            this.motionService.updateCharacteristic('MotionDetected', false);
+            this.resetTimer = undefined;
+            this.log.debug('Reset sensor %s', this.accessory.displayName);
+        }, this.resetAfterSeconds * 1000);
+        this.resetTimer.unref();
+    }
+    stop() {
+        if (this.resetTimer) {
+            clearTimeout(this.resetTimer);
+            this.resetTimer = undefined;
+        }
+    }
+}
+//# sourceMappingURL=sensor.js.map

package/dist/sensor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensor.js","sourceRoot":"","sources":["../src/sensor.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAY;IAIJ;IACA;IACA;IACA;IANX,UAAU,CAAkB;IAEpC,YACmB,SAA4B,EAC5B,aAAsB,EACtB,GAAY,EACZ,iBAAyB;QAHzB,cAAS,GAAT,SAAS,CAAmB;QAC5B,kBAAa,GAAb,aAAa,CAAS;QACtB,QAAG,GAAH,GAAG,CAAS;QACZ,sBAAiB,GAAjB,iBAAiB,CAAQ;IACzC,CAAC;IAEJ,OAAO;QACL,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAEpE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;YACjE,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAChE,CAAC,EAAE,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;QAElC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC;IACH,CAAC;CACF"}

package/dist/settings.d.ts

@@ -0,0 +1,5 @@
+export declare const PLATFORM_NAME = "ChangeDetection";
+export declare const PLUGIN_NAME = "homebridge-changedetection";
+export declare const DEFAULT_PORT = 3210;
+export declare const DEFAULT_BIND_ADDRESS = "0.0.0.0";
+export declare const DEFAULT_RESET_SECONDS = 10;

package/dist/settings.js

@@ -0,0 +1,6 @@
+export const PLATFORM_NAME = 'ChangeDetection';
+export const PLUGIN_NAME = 'homebridge-changedetection';
+export const DEFAULT_PORT = 3210;
+export const DEFAULT_BIND_ADDRESS = '0.0.0.0';
+export const DEFAULT_RESET_SECONDS = 10;
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAG,4BAA4B,CAAC;AACxD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AACjC,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAC9C,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformConfig } from 'homebridge';
+export interface SensorConfig {
+    id: string;
+    name: string;
+}
+export interface ChangeDetectionConfig extends PlatformConfig {
+    bindAddress?: string;
+    port?: number;
+    resetAfterSeconds?: number;
+    sensors?: SensorConfig[];
+    token?: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/webhook-server.d.ts

@@ -0,0 +1,18 @@
+export interface WebhookServerOptions {
+    bindAddress: string;
+    onTrigger: (id: string) => boolean;
+    port: number;
+    token: string;
+}
+export declare class WebhookServer {
+    private readonly options;
+    private server?;
+    constructor(options: WebhookServerOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    address(): string | null;
+    private handle;
+    private authorized;
+    private consumeBody;
+    private send;
+}

package/dist/webhook-server.js

@@ -0,0 +1,105 @@
+import { timingSafeEqual } from 'node:crypto';
+import { createServer } from 'node:http';
+const MAX_BODY_BYTES = 64 * 1024;
+export class WebhookServer {
+    options;
+    server;
+    constructor(options) {
+        this.options = options;
+    }
+    async start() {
+        if (this.server) {
+            return;
+        }
+        const server = createServer((request, response) => {
+            void this.handle(request, response);
+        });
+        this.server = server;
+        await new Promise((resolve, reject) => {
+            const onError = (error) => {
+                this.server = undefined;
+                reject(error);
+            };
+            server.once('error', onError);
+            server.listen(this.options.port, this.options.bindAddress, () => {
+                server.removeListener('error', onError);
+                resolve();
+            });
+        });
+    }
+    async stop() {
+        const server = this.server;
+        this.server = undefined;
+        if (!server || !server.listening) {
+            return;
+        }
+        await new Promise((resolve, reject) => {
+            server.close(error => error ? reject(error) : resolve());
+        });
+    }
+    address() {
+        const address = this.server?.address();
+        if (!address || typeof address === 'string') {
+            return address ?? null;
+        }
+        return `${address.address}:${address.port}`;
+    }
+    async handle(request, response) {
+        const url = new URL(request.url ?? '/', 'http://localhost');
+        if (request.method === 'GET' && url.pathname === '/health') {
+            this.send(response, 200, { status: 'ok' });
+            return;
+        }
+        if (request.method !== 'POST') {
+            this.send(response, 404, { error: 'not_found' });
+            return;
+        }
+        const match = /^\/webhook\/([^/]+)$/.exec(url.pathname);
+        if (!match) {
+            this.send(response, 404, { error: 'not_found' });
+            return;
+        }
+        if (!this.authorized(request)) {
+            this.send(response, 401, { error: 'unauthorized' });
+            return;
+        }
+        try {
+            await this.consumeBody(request);
+        }
+        catch {
+            this.send(response, 413, { error: 'payload_too_large' });
+            return;
+        }
+        const id = decodeURIComponent(match[1]);
+        if (!this.options.onTrigger(id)) {
+            this.send(response, 404, { error: 'unknown_sensor' });
+            return;
+        }
+        this.send(response, 202, { accepted: true, id });
+    }
+    authorized(request) {
+        const header = request.headers['x-changedetection-token'];
+        const supplied = Array.isArray(header) ? header[0] : header;
+        if (!supplied) {
+            return false;
+        }
+        const expectedBuffer = Buffer.from(this.options.token);
+        const suppliedBuffer = Buffer.from(supplied);
+        return expectedBuffer.length === suppliedBuffer.length
+            && timingSafeEqual(expectedBuffer, suppliedBuffer);
+    }
+    async consumeBody(request) {
+        let size = 0;
+        for await (const chunk of request) {
+            size += Buffer.byteLength(chunk);
+            if (size > MAX_BODY_BYTES) {
+                throw new Error('Payload too large');
+            }
+        }
+    }
+    send(response, status, body) {
+        response.writeHead(status, { 'content-type': 'application/json; charset=utf-8' });
+        response.end(JSON.stringify(body));
+    }
+}
+//# sourceMappingURL=webhook-server.js.map

package/dist/webhook-server.js.map

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

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "homebridge-changedetection",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "displayName": "ChangeDetection",
+  "version": "0.1.4",
+  "description": "Expose changedetection.io webhook events as HomeKit motion sensors.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "config.schema.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": "^22.10.0 || ^24.0.0",
+    "homebridge": "^1.8.0 || ^2.0.0"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsc",
+    "check": "npm run lint && npm run build && npm test",
+    "lint": "eslint . --max-warnings=0",
+    "prepublishOnly": "npm run check",
+    "test": "node --test test/*.test.mjs"
+  },
+  "keywords": [
+    "homebridge-plugin",
+    "supports-hap",
+    "changedetection.io",
+    "changedetection",
+    "homekit",
+    "webhook"
+  ],
+  "author": "Alexxanddr",
+  "license": "MIT",
+  "homepage": "https://github.com/Alexxanddr/homebridge-changedetection#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Alexxanddr/homebridge-changedetection.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Alexxanddr/homebridge-changedetection/issues"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.0",
+    "@types/node": "^24.0.0",
+    "eslint": "^10.0.0",
+    "homebridge": "^2.0.0",
+    "rimraf": "^6.0.0",
+    "typescript": "^5.9.0",
+    "typescript-eslint": "^8.0.0"
+  }
+}