homebridge-pollen 1.0.0

package/.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

package/CLAUDE.md

@@ -0,0 +1,98 @@
+# CLAUDE.md
+
+## Project Overview
+
+Homebridge dynamic platform plugin that fetches pollen data from the Ambee API and exposes it as HomeKit accessories. No runtime dependencies — uses Node.js 20+ built-in `fetch`.
+
+## Commands
+
+- `npm run build` — clean compile TypeScript to `dist/`
+- `npm run lint` — ESLint
+- `npm run dev` — build, link, and start Homebridge with nodemon (auto-restarts on src changes)
+
+## Homebridge Plugin Architecture
+
+### Registration
+
+A Homebridge plugin exports a default function that receives the `API` object and calls `api.registerPlatform(PLATFORM_NAME, PlatformClass)`. The platform name here must match `pluginAlias` in `config.schema.json`. The npm package name (`homebridge-pollen`) is how Homebridge discovers the plugin.
+
+### Dynamic Platform Plugin Lifecycle
+
+The plugin implements `DynamicPlatformPlugin` from `homebridge`. The lifecycle is:
+
+1. **Constructor** — called with `(log, config, api)`. Set up state but do NOT create accessories here. Register a `didFinishLaunching` listener on the API.
+2. **`configureAccessory(accessory)`** — Homebridge calls this for each accessory it has cached on disk. The plugin must store these in a list. This is called *before* `didFinishLaunching`.
+3. **`didFinishLaunching` event** — now safe to create/remove accessories. Compare desired accessories against the cached list:
+   - Cached and still desired → restore (call `api.updatePlatformAccessories`)
+   - Not cached → create via `new api.platformAccessory(name, uuid)` then `api.registerPlatformAccessories`
+   - Cached but no longer desired → remove via `api.unregisterPlatformAccessories`
+4. **`shutdown` event** — clean up timers and connections.
+
+### Accessory UUIDs
+
+UUIDs must be deterministic and stable across restarts. Generate them with `api.hap.uuid.generate(stableString)`. This plugin uses `pollen-{category}-{level}-{location}` as the stable string. If the UUID changes, Homebridge treats it as a new accessory and the old one becomes stale.
+
+### Services and Characteristics
+
+Each `PlatformAccessory` has one or more `Service` objects. Always check `accessory.getService(ServiceType)` before calling `addService` to avoid duplicates on restore from cache.
+
+Key pattern for getting/setting services:
+```ts
+const service = accessory.getService(api.hap.Service.ContactSensor)
+  || accessory.addService(api.hap.Service.ContactSensor, displayName);
+```
+
+**Push model** — use `service.updateCharacteristic(CharType, value)` to push updates. This is preferred over registering `onGet` handlers when data is fetched on a polling interval. HomeKit GET requests return the last pushed value instantly.
+
+### HomeKit Service Types Used
+
+- **ContactSensor** — `ContactSensorState`: `CONTACT_DETECTED` (0) or `CONTACT_NOT_DETECTED` (1). Used because contact sensor state changes are native HomeKit automation triggers ("When X detected...").
+- **AirQualitySensor** — `AirQuality`: `UNKNOWN` (0), `EXCELLENT` (1), `GOOD` (2), `FAIR` (3), `INFERIOR` (4), `POOR` (5).
+- **AccessoryInformation** — always present on every accessory. Set `Manufacturer`, `Model`, `SerialNumber`.
+
+### config.schema.json
+
+This file defines the Homebridge UI configuration form. Key fields:
+
+- `pluginAlias` — must match `PLATFORM_NAME` passed to `api.registerPlatform()`
+- `pluginType` — `"platform"` for platform plugins
+- `singular: true` — only one instance of this platform allowed
+- `schema.properties` — defines form fields. Use `"required": true` on required fields. Nested objects with `"expandable": true` render as collapsible sections in the UI.
+
+### TypeScript Configuration
+
+- Target `ES2022` with `module: nodenext` / `moduleResolution: nodenext`
+- Imports must use `.js` extensions (e.g., `import { Foo } from './foo.js'`) — this is required by nodenext module resolution even though the source files are `.ts`
+- `@types/node` is needed for `fetch`, `setInterval`, `clearInterval` globals
+
+## Ambee API
+
+- **Endpoint**: `GET https://api.ambeedata.com/latest/pollen/by-place?place={location}`
+- **Auth**: `x-api-key` header with API key
+- **Free tier**: 100 calls/day — default 60-min polling = 24 calls/day
+- **Response shape**: `{ message: string, data: [{ Count: { grass_pollen, tree_pollen, weed_pollen }, Risk: {...}, Species: {...}, updatedAt: string }] }`
+- The `by-place` endpoint accepts zip codes and place names directly
+
+## Pollen Thresholds
+
+Default thresholds based on NAB (National Allergy Bureau) guidelines. A count is classified as:
+- **Low** if `count <= threshold.low`
+- **High** if `count >= threshold.high`
+- **Medium** otherwise
+
+| Category | Low | High |
+|----------|-----|------|
+| Overall  | 50  | 200  |
+| Tree     | 15  | 90   |
+| Grass    | 20  | 200  |
+| Weed     | 10  | 50   |
+
+Users can override these via `config.thresholds`.
+
+## Error Handling
+
+- Missing `apiKey`/`location` — logs error, plugin does not start polling
+- 401 — logs clear message about invalid API key, returns cached data
+- 429 — logs warning, increments consecutive failure counter for exponential backoff
+- Network/5xx — logs warning, returns cached data, retries next cycle
+- Empty data array — logs warning about unsupported location, retains cache

package/CONTRIBUTING.md

@@ -0,0 +1,89 @@
+# Contributing
+
+## Local Development
+
+### Prerequisites
+
+- Node.js 20 or later
+- An [Ambee API key](https://api-dashboard.getambee.com/) (free tier works fine)
+
+### Quick start
+
+Run the setup script to install dependencies, create the local Homebridge config, and link the plugin:
+
+```sh
+npm run setup
+```
+
+The script will prompt you for your Ambee API key and location. 
+
+### Development
+
+```sh
+npm run dev
+```
+
+The development workflow runs an isolated local Homebridge instance, completely separate from any system-wide Homebridge installation you may have:
+
+- `./.homebridge` folder holds its own `config.json` and cache
+- **`npm link`** — Makes the plugin discoverable to Homebridge without publishing to npm
+- **`nodemon`** — Watches `src/` and automatically rebuilds TypeScript and restarts Homebridge on every change
+
+
+### Build
+
+```sh
+npm run build 
+```
+
+### Testing the plugin
+
+After running `npm run setup` and `npm run dev`, verify in the console output that:
+
+- 3 ContactSensor accessories are registered (Pollen High, Pollen Medium, Pollen Low)
+- An initial pollen fetch completes and one sensor shows `DETECTED`
+- Debug log lines show the fetched counts and level classifications
+
+To test optional features, edit `.homebridge/config.json` and add:
+
+```json
+{
+  "platform": "HomebridgePollen",
+  "apiKey": "YOUR_AMBEE_API_KEY",
+  "location": "10001",
+  "enableCategorySensors": true,
+  "enableAirQualitySensor": true
+}
+```
+
+This adds 9 per-category sensors (Tree/Grass/Weed x High/Medium/Low) and 1 AirQualitySensor. Restart the dev server to pick up the changes.
+
+### Pairing with Apple Home
+
+To test end-to-end in the Home app:
+
+1. Open the Home app on iOS or macOS
+2. Tap **+** > **Add Accessory** > **More Options...**
+3. Select "Test Homebridge" from the list
+4. Enter the PIN: `031-45-154`
+
+The test bridge uses port 51826, so it can run alongside a production Homebridge instance on the default port. When you're done testing, unpair the bridge from Home to avoid stale accessories.
+
+### Project Structure
+
+```
+src/
+├── index.ts              # Entry point — registers platform with Homebridge
+├── settings.ts           # Constants and default thresholds
+├── types.ts              # TypeScript interfaces and helper functions
+├── pollenService.ts      # Ambee API client (fetch, parse, cache)
+├── platform.ts           # DynamicPlatformPlugin (discovery, polling)
+└── platformAccessory.ts  # Maps pollen data to HomeKit services
+```
+
+## Submitting Changes
+
+1. Create a branch from `main`.
+2. Make your changes and verify `npm run build` and `npm run lint` pass.
+3. Test against a local Homebridge instance using the steps above.
+4. Open a pull request with a description of what changed and why.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Patrick Burtchaell
+
+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

@@ -0,0 +1,125 @@
+# homebridge-pollen
+
+[![npm](https://img.shields.io/npm/v/homebridge-pollen)](https://www.npmjs.com/package/homebridge-pollen)
+[![license](https://img.shields.io/npm/l/homebridge-pollen)](LICENSE)
+
+Homebridge plugin that exposes pollen levels as HomeKit sensors using the [Ambee API](https://www.getambee.com/).
+
+## Features
+
+- **Contact sensors for automations** — Pollen levels are exposed as contact sensors, which can trigger HomeKit automations natively ("When Pollen High detected...")
+- **Per-category sensors** — Optionally add separate sensors for tree, grass, and weed pollen
+- **Air quality sensor** — Optionally add an air quality sensor that maps overall pollen count to a 1-5 severity scale
+- **No runtime dependencies** — Uses Node.js 20+ built-in `fetch`
+
+## Requirements
+
+- Node.js 20.0.0 or later
+- Homebridge 1.8.0 or later (including Homebridge 2.x)
+
+## Installation
+
+### Using the Homebridge UI
+
+Search for `homebridge-pollen` in the Homebridge UI plugin search and install it.
+
+### Using npm
+
+```bash
+npm install -g homebridge-pollen
+```
+
+## Getting an API key
+
+This plugin requires an API key from Ambee to fetch pollen data.
+
+1. Go to the [Ambee API Dashboard](https://api-dashboard.getambee.com/)
+2. Create a free account
+3. Copy your API key from the dashboard
+
+The free tier allows 100 API calls per day. With the default 60-minute poll interval, the plugin uses approximately 24 calls per day.
+
+## Configuration
+
+You can configure the plugin using the Homebridge UI or by editing your `config.json` directly.
+
+### Example configuration
+
+```json
+{
+  "platforms": [
+    {
+      "platform": "HomebridgePollen",
+      "apiKey": "your-ambee-api-key",
+      "location": "10001"
+    }
+  ]
+}
+```
+
+### Configuration options
+
+| Option | Required | Default | Description |
+|--------|----------|---------|-------------|
+| `platform` | Yes | — | Must be `HomebridgePollen` |
+| `apiKey` | Yes | — | Your Ambee API key |
+| `location` | Yes | — | Zip code or place name to fetch pollen data for |
+| `pollInterval` | No | `60` | How often to fetch pollen data, in minutes (minimum 15) |
+| `enableCategorySensors` | No | `false` | Add 9 additional sensors for tree/grass/weed at each level |
+| `enableAirQualitySensor` | No | `false` | Add an air quality sensor accessory |
+| `thresholds` | No | — | Override default pollen count thresholds (see below) |
+
+## How it works
+
+The plugin creates contact sensors that represent pollen levels. By default, you get three sensors:
+
+- **Pollen High** — Triggered when pollen count is high
+- **Pollen Medium** — Triggered when pollen count is medium  
+- **Pollen Low** — Triggered when pollen count is low
+
+Contact sensors are used because their state changes are native HomeKit automation triggers. This lets you create automations like "When Pollen High is detected, turn on the air purifier."
+
+### Optional sensors
+
+When `enableCategorySensors` is enabled, you get 9 additional sensors:
+
+- Tree Pollen High / Medium / Low
+- Grass Pollen High / Medium / Low
+- Weed Pollen High / Medium / Low
+
+When `enableAirQualitySensor` is enabled, you get a single air quality sensor that maps the overall pollen count to HomeKit's 5-level air quality scale.
+
+## Pollen thresholds
+
+Pollen counts are classified as Low, Medium, or High based on thresholds from the National Allergy Bureau (NAB). You can override these defaults in your configuration.
+
+| Category | Low (at or below) | High (at or above) |
+|----------|-------------------|---------------------|
+| Overall | 50 | 200 |
+| Tree | 15 | 90 |
+| Grass | 20 | 200 |
+| Weed | 10 | 50 |
+
+Counts between the low and high thresholds are classified as Medium.
+
+### Customizing thresholds
+
+```json
+{
+  "platforms": [
+    {
+      "platform": "HomebridgePollen",
+      "apiKey": "your-api-key",
+      "location": "10001",
+      "thresholds": {
+        "overall": { "low": 30, "high": 150 },
+        "tree": { "low": 10, "high": 60 }
+      }
+    }
+  ]
+}
+```
+
+## License
+
+[MIT](LICENSE)

package/config.schema.json

@@ -0,0 +1,118 @@
+{
+  "pluginAlias": "HomebridgePollen",
+  "pluginType": "platform",
+  "singular": true,
+  "headerDisplay": "Exposes pollen levels from the [Ambee API](https://www.getambee.com/) as HomeKit contact sensors for automation.",
+  "footerDisplay": "For help, see the [README](https://github.com/pburtchaell/homebridge-pollen).",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "apiKey": {
+        "title": "API Key",
+        "type": "string",
+        "required": true,
+        "description": "Your Ambee API key. Get one at https://api-dashboard.getambee.com/"
+      },
+      "location": {
+        "title": "Location",
+        "type": "string",
+        "required": true,
+        "placeholder": "10001",
+        "description": "Zip code or place name to fetch pollen data for."
+      },
+      "pollInterval": {
+        "title": "Poll Interval (minutes)",
+        "type": "integer",
+        "default": 60,
+        "minimum": 15,
+        "description": "How often to fetch pollen data from Ambee. Minimum 15 minutes. Free tier allows ~100 calls/day."
+      },
+      "enableCategorySensors": {
+        "title": "Enable Per-Category Sensors",
+        "type": "boolean",
+        "default": false,
+        "description": "Add 9 additional sensors for Tree/Grass/Weed x High/Medium/Low."
+      },
+      "enableAirQualitySensor": {
+        "title": "Enable Air Quality Sensor",
+        "type": "boolean",
+        "default": false,
+        "description": "Add an AirQualitySensor accessory that maps overall pollen count to a 1-5 severity scale."
+      },
+      "thresholds": {
+        "title": "Threshold Overrides",
+        "type": "object",
+        "expandable": true,
+        "description": "Override default pollen count thresholds for level classification.",
+        "properties": {
+          "overall": {
+            "title": "Overall",
+            "type": "object",
+            "properties": {
+              "low": {
+                "title": "Low Threshold",
+                "type": "integer",
+                "default": 50,
+                "description": "Counts at or below this value are classified as Low."
+              },
+              "high": {
+                "title": "High Threshold",
+                "type": "integer",
+                "default": 200,
+                "description": "Counts at or above this value are classified as High."
+              }
+            }
+          },
+          "tree": {
+            "title": "Tree",
+            "type": "object",
+            "properties": {
+              "low": {
+                "title": "Low Threshold",
+                "type": "integer",
+                "default": 15
+              },
+              "high": {
+                "title": "High Threshold",
+                "type": "integer",
+                "default": 90
+              }
+            }
+          },
+          "grass": {
+            "title": "Grass",
+            "type": "object",
+            "properties": {
+              "low": {
+                "title": "Low Threshold",
+                "type": "integer",
+                "default": 20
+              },
+              "high": {
+                "title": "High Threshold",
+                "type": "integer",
+                "default": 200
+              }
+            }
+          },
+          "weed": {
+            "title": "Weed",
+            "type": "object",
+            "properties": {
+              "low": {
+                "title": "Low Threshold",
+                "type": "integer",
+                "default": 10
+              },
+              "high": {
+                "title": "High Threshold",
+                "type": "integer",
+                "default": 50
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

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,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const settings_js_1 = require("./settings.js");
+const platform_js_1 = require("./platform.js");
+exports.default = (api) => {
+    api.registerPlatform(settings_js_1.PLATFORM_NAME, platform_js_1.PollenPlatform);
+};
+//# 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,+CAA8C;AAC9C,+CAA+C;AAE/C,kBAAe,CAAC,GAAQ,EAAE,EAAE;IAC1B,GAAG,CAAC,gBAAgB,CAAC,2BAAa,EAAE,4BAAc,CAAC,CAAC;AACtD,CAAC,CAAC"}

package/dist/platform.d.ts

@@ -0,0 +1,16 @@
+import type { API, DynamicPlatformPlugin, Logger, PlatformAccessory, PlatformConfig } from 'homebridge';
+export declare class PollenPlatform implements DynamicPlatformPlugin {
+    readonly log: Logger;
+    readonly config: PlatformConfig;
+    readonly api: API;
+    private readonly cachedAccessories;
+    private readonly handlers;
+    private pollenService?;
+    private pollTimer?;
+    constructor(log: Logger, config: PlatformConfig, api: API);
+    configureAccessory(accessory: PlatformAccessory): void;
+    private discoverDevices;
+    private buildAccessoryDefinitions;
+    private startPolling;
+    private poll;
+}

package/dist/platform.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PollenPlatform = void 0;
+const settings_js_1 = require("./settings.js");
+const types_js_1 = require("./types.js");
+const pollenService_js_1 = require("./pollenService.js");
+const platformAccessory_js_1 = require("./platformAccessory.js");
+class PollenPlatform {
+    log;
+    config;
+    api;
+    cachedAccessories = [];
+    handlers = new Map();
+    pollenService;
+    pollTimer;
+    constructor(log, config, api) {
+        this.log = log;
+        this.config = config;
+        this.api = api;
+        const pollenConfig = config;
+        if (!pollenConfig.apiKey || !pollenConfig.location) {
+            this.log.error('Missing required configuration: apiKey and location must be set. '
+                + 'Plugin will not start.');
+            return;
+        }
+        const thresholds = (0, types_js_1.resolveThresholds)(pollenConfig, settings_js_1.DEFAULT_THRESHOLDS);
+        this.pollenService = new pollenService_js_1.PollenService(pollenConfig.apiKey, pollenConfig.location, thresholds, this.log);
+        this.api.on('didFinishLaunching', () => {
+            this.discoverDevices(pollenConfig);
+            this.startPolling(pollenConfig);
+        });
+        this.api.on('shutdown', () => {
+            if (this.pollTimer) {
+                clearInterval(this.pollTimer);
+            }
+        });
+    }
+    configureAccessory(accessory) {
+        this.log.info(`Loading accessory from cache: ${accessory.displayName}`);
+        this.cachedAccessories.push(accessory);
+    }
+    discoverDevices(config) {
+        const definitions = this.buildAccessoryDefinitions(config);
+        const desiredUUIDs = new Set();
+        for (const definition of definitions) {
+            const uuid = this.api.hap.uuid.generate(definition.id);
+            desiredUUIDs.add(uuid);
+            const existingAccessory = this.cachedAccessories.find(a => a.UUID === uuid);
+            if (existingAccessory) {
+                this.log.info(`Restoring accessory from cache: ${existingAccessory.displayName}`);
+                existingAccessory.context.definition = definition;
+                const handler = new platformAccessory_js_1.PollenAccessoryHandler(existingAccessory, definition, this.api, this.log);
+                this.handlers.set(uuid, handler);
+                this.api.updatePlatformAccessories([existingAccessory]);
+            }
+            else {
+                this.log.info(`Adding new accessory: ${definition.name}`);
+                const accessory = new this.api.platformAccessory(definition.name, uuid);
+                accessory.context.definition = definition;
+                const handler = new platformAccessory_js_1.PollenAccessoryHandler(accessory, definition, this.api, this.log);
+                this.handlers.set(uuid, handler);
+                this.api.registerPlatformAccessories(settings_js_1.PLUGIN_NAME, settings_js_1.PLATFORM_NAME, [accessory]);
+            }
+        }
+        // Remove stale accessories
+        const staleAccessories = this.cachedAccessories.filter(a => !desiredUUIDs.has(a.UUID));
+        if (staleAccessories.length > 0) {
+            this.log.info(`Removing ${staleAccessories.length} stale accessory(ies)`);
+            this.api.unregisterPlatformAccessories(settings_js_1.PLUGIN_NAME, settings_js_1.PLATFORM_NAME, staleAccessories);
+        }
+    }
+    buildAccessoryDefinitions(config) {
+        const location = config.location;
+        const definitions = [];
+        // Default 3 overall sensors: High, Medium, Low
+        const overallLevels = ['High', 'Medium', 'Low'];
+        for (const level of overallLevels) {
+            definitions.push({
+                id: `pollen-overall-${level}-${location}`,
+                name: `Pollen ${level}`,
+                type: 'contact',
+                level,
+                category: 'overall',
+            });
+        }
+        // Optional per-category sensors (9 total)
+        if (config.enableCategorySensors) {
+            const categories = ['tree', 'grass', 'weed'];
+            const levels = ['High', 'Medium', 'Low'];
+            for (const category of categories) {
+                for (const level of levels) {
+                    const label = category.charAt(0).toUpperCase() + category.slice(1);
+                    definitions.push({
+                        id: `pollen-${category}-${level}-${location}`,
+                        name: `${label} Pollen ${level}`,
+                        type: 'contact',
+                        level,
+                        category,
+                    });
+                }
+            }
+        }
+        // Optional air quality sensor
+        if (config.enableAirQualitySensor) {
+            definitions.push({
+                id: `pollen-airquality-${location}`,
+                name: 'Pollen Air Quality',
+                type: 'airquality',
+            });
+        }
+        return definitions;
+    }
+    startPolling(config) {
+        if (!this.pollenService) {
+            return;
+        }
+        const intervalMinutes = Math.max(config.pollInterval ?? settings_js_1.DEFAULT_POLL_INTERVAL, settings_js_1.MIN_POLL_INTERVAL);
+        const intervalMs = intervalMinutes * 60 * 1000;
+        this.log.info(`Polling Ambee API every ${intervalMinutes} minutes for location "${config.location}"`);
+        // Immediate first fetch
+        this.poll();
+        this.pollTimer = setInterval(() => {
+            const backoff = this.pollenService.getBackoffMultiplier();
+            if (backoff > 1) {
+                this.log.debug(`Backoff active (${backoff}x). Skipping this poll cycle.`);
+                return;
+            }
+            this.poll();
+        }, intervalMs);
+    }
+    async poll() {
+        if (!this.pollenService) {
+            return;
+        }
+        const data = await this.pollenService.fetchPollenData();
+        if (!data) {
+            this.log.debug('No pollen data available (no cached data yet).');
+            return;
+        }
+        for (const handler of this.handlers.values()) {
+            handler.updatePollenData(data);
+        }
+    }
+}
+exports.PollenPlatform = PollenPlatform;
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

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

package/dist/platformAccessory.d.ts

@@ -0,0 +1,15 @@
+import type { API, Logger, PlatformAccessory } from 'homebridge';
+import type { AccessoryDefinition, ParsedPollenData } from './types.js';
+export declare class PollenAccessoryHandler {
+    private readonly accessory;
+    private readonly definition;
+    private readonly api;
+    private readonly log;
+    private readonly service;
+    private readonly Characteristic;
+    constructor(accessory: PlatformAccessory, definition: AccessoryDefinition, api: API, log: Logger);
+    updatePollenData(data: ParsedPollenData): void;
+    private updateContactSensor;
+    private updateAirQuality;
+    private mapCountToAirQuality;
+}

package/dist/platformAccessory.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PollenAccessoryHandler = void 0;
+class PollenAccessoryHandler {
+    accessory;
+    definition;
+    api;
+    log;
+    service;
+    Characteristic;
+    constructor(accessory, definition, api, log) {
+        this.accessory = accessory;
+        this.definition = definition;
+        this.api = api;
+        this.log = log;
+        this.Characteristic = this.api.hap.Characteristic;
+        this.accessory.getService(this.api.hap.Service.AccessoryInformation)
+            .setCharacteristic(this.Characteristic.Manufacturer, 'Ambee')
+            .setCharacteristic(this.Characteristic.Model, 'Pollen Sensor')
+            .setCharacteristic(this.Characteristic.SerialNumber, definition.id);
+        if (definition.type === 'airquality') {
+            this.service = this.accessory.getService(this.api.hap.Service.AirQualitySensor)
+                || this.accessory.addService(this.api.hap.Service.AirQualitySensor, definition.name);
+        }
+        else {
+            this.service = this.accessory.getService(this.api.hap.Service.ContactSensor)
+                || this.accessory.addService(this.api.hap.Service.ContactSensor, definition.name);
+        }
+        this.service.setCharacteristic(this.Characteristic.Name, definition.name);
+    }
+    updatePollenData(data) {
+        if (this.definition.type === 'airquality') {
+            this.updateAirQuality(data);
+        }
+        else {
+            this.updateContactSensor(data);
+        }
+    }
+    updateContactSensor(data) {
+        const category = this.definition.category;
+        const targetLevel = this.definition.level;
+        const currentLevel = data[category].level;
+        const isDetected = currentLevel === targetLevel;
+        const state = isDetected
+            ? this.Characteristic.ContactSensorState.CONTACT_DETECTED
+            : this.Characteristic.ContactSensorState.CONTACT_NOT_DETECTED;
+        this.service.updateCharacteristic(this.Characteristic.ContactSensorState, state);
+        this.log.debug(`${this.definition.name}: ${category} level is ${currentLevel}, `
+            + `sensor ${targetLevel} → ${isDetected ? 'DETECTED' : 'NOT_DETECTED'}`);
+    }
+    updateAirQuality(data) {
+        const quality = this.mapCountToAirQuality(data.overall.count);
+        this.service.updateCharacteristic(this.Characteristic.AirQuality, quality);
+        this.log.debug(`${this.definition.name}: overall count=${data.overall.count}, AirQuality=${quality}`);
+    }
+    mapCountToAirQuality(count) {
+        // Map total pollen count to HomeKit AirQuality enum (0-5)
+        // 0=UNKNOWN, 1=EXCELLENT, 2=GOOD, 3=FAIR, 4=INFERIOR, 5=POOR
+        if (count <= 20) {
+            return this.Characteristic.AirQuality.EXCELLENT;
+        }
+        if (count <= 80) {
+            return this.Characteristic.AirQuality.GOOD;
+        }
+        if (count <= 200) {
+            return this.Characteristic.AirQuality.FAIR;
+        }
+        if (count <= 400) {
+            return this.Characteristic.AirQuality.INFERIOR;
+        }
+        return this.Characteristic.AirQuality.POOR;
+    }
+}
+exports.PollenAccessoryHandler = PollenAccessoryHandler;
+//# sourceMappingURL=platformAccessory.js.map

package/dist/platformAccessory.js.map

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

package/dist/pollenService.d.ts

@@ -0,0 +1,15 @@
+import type { Logger } from 'homebridge';
+import type { Thresholds } from './settings.js';
+import type { ParsedPollenData } from './types.js';
+export declare class PollenService {
+    private readonly apiKey;
+    private readonly location;
+    private readonly thresholds;
+    private readonly log;
+    private cache;
+    private consecutiveFailures;
+    constructor(apiKey: string, location: string, thresholds: Thresholds, log: Logger);
+    fetchPollenData(): Promise<ParsedPollenData | null>;
+    getBackoffMultiplier(): number;
+    getCachedData(): ParsedPollenData | null;
+}

package/dist/pollenService.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PollenService = void 0;
+const settings_js_1 = require("./settings.js");
+const types_js_1 = require("./types.js");
+class PollenService {
+    apiKey;
+    location;
+    thresholds;
+    log;
+    cache = null;
+    consecutiveFailures = 0;
+    constructor(apiKey, location, thresholds, log) {
+        this.apiKey = apiKey;
+        this.location = location;
+        this.thresholds = thresholds;
+        this.log = log;
+    }
+    async fetchPollenData() {
+        const url = `${settings_js_1.AMBEE_BASE_URL}/latest/pollen/by-place?place=${encodeURIComponent(this.location)}`;
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'x-api-key': this.apiKey,
+                    'Content-Type': 'application/json',
+                },
+            });
+            if (response.status === 401) {
+                this.log.error('Ambee API returned 401 Unauthorized. Check that your API key is valid.');
+                return this.cache;
+            }
+            if (response.status === 429) {
+                this.consecutiveFailures++;
+                this.log.warn('Ambee API rate limit reached (429). Will retry next cycle. '
+                    + `Consecutive failures: ${this.consecutiveFailures}`);
+                return this.cache;
+            }
+            if (!response.ok) {
+                this.consecutiveFailures++;
+                this.log.warn(`Ambee API returned ${response.status}. `
+                    + `Returning cached data. Consecutive failures: ${this.consecutiveFailures}`);
+                return this.cache;
+            }
+            const body = await response.json();
+            if (!body.data || body.data.length === 0) {
+                this.log.warn(`Ambee API returned no pollen data for location "${this.location}". `
+                    + 'The location may not be supported. Retaining cached data.');
+                return this.cache;
+            }
+            const item = body.data[0];
+            const treeCount = item.Count.tree_pollen;
+            const grassCount = item.Count.grass_pollen;
+            const weedCount = item.Count.weed_pollen;
+            const totalCount = treeCount + grassCount + weedCount;
+            const parsed = {
+                overall: {
+                    count: totalCount,
+                    level: (0, types_js_1.classifyLevel)(totalCount, this.thresholds.overall),
+                },
+                tree: {
+                    count: treeCount,
+                    level: (0, types_js_1.classifyLevel)(treeCount, this.thresholds.tree),
+                },
+                grass: {
+                    count: grassCount,
+                    level: (0, types_js_1.classifyLevel)(grassCount, this.thresholds.grass),
+                },
+                weed: {
+                    count: weedCount,
+                    level: (0, types_js_1.classifyLevel)(weedCount, this.thresholds.weed),
+                },
+                timestamp: item.updatedAt,
+            };
+            this.cache = parsed;
+            this.consecutiveFailures = 0;
+            this.log.debug(`Pollen data updated: overall=${totalCount} (${parsed.overall.level}), `
+                + `tree=${treeCount} (${parsed.tree.level}), `
+                + `grass=${grassCount} (${parsed.grass.level}), `
+                + `weed=${weedCount} (${parsed.weed.level})`);
+            return parsed;
+        }
+        catch (error) {
+            this.consecutiveFailures++;
+            this.log.warn(`Failed to fetch pollen data: ${error instanceof Error ? error.message : error}. `
+                + `Returning cached data. Consecutive failures: ${this.consecutiveFailures}`);
+            return this.cache;
+        }
+    }
+    getBackoffMultiplier() {
+        if (this.consecutiveFailures <= 1) {
+            return 1;
+        }
+        return Math.min(2 ** (this.consecutiveFailures - 1), 16);
+    }
+    getCachedData() {
+        return this.cache;
+    }
+}
+exports.PollenService = PollenService;
+//# sourceMappingURL=pollenService.js.map

package/dist/pollenService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pollenService.js","sourceRoot":"","sources":["../src/pollenService.ts"],"names":[],"mappings":";;;AACA,+CAA+C;AAG/C,yCAA2C;AAE3C,MAAa,aAAa;IAKL;IACA;IACA;IACA;IAPX,KAAK,GAA4B,IAAI,CAAC;IACtC,mBAAmB,GAAG,CAAC,CAAC;IAEhC,YACmB,MAAc,EACd,QAAgB,EAChB,UAAsB,EACtB,GAAW;QAHX,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAQ;QAChB,eAAU,GAAV,UAAU,CAAY;QACtB,QAAG,GAAH,GAAG,CAAQ;IAC3B,CAAC;IAEJ,KAAK,CAAC,eAAe;QACnB,MAAM,GAAG,GAAG,GAAG,4BAAc,iCAAiC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAElG,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,OAAO,EAAE;oBACP,WAAW,EAAE,IAAI,CAAC,MAAM;oBACxB,cAAc,EAAE,kBAAkB;iBACnC;aACF,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;gBACzF,OAAO,IAAI,CAAC,KAAK,CAAC;YACpB,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,6DAA6D;sBAC3D,yBAAyB,IAAI,CAAC,mBAAmB,EAAE,CACtD,CAAC;gBACF,OAAO,IAAI,CAAC,KAAK,CAAC;YACpB,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,sBAAsB,QAAQ,CAAC,MAAM,IAAI;sBACvC,gDAAgD,IAAI,CAAC,mBAAmB,EAAE,CAC7E,CAAC;gBACF,OAAO,IAAI,CAAC,KAAK,CAAC;YACpB,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAyB,CAAC;YAE1D,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzC,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,mDAAmD,IAAI,CAAC,QAAQ,KAAK;sBACnE,2DAA2D,CAC9D,CAAC;gBACF,OAAO,IAAI,CAAC,KAAK,CAAC;YACpB,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;YACzC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;YAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;YACzC,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;YAEtD,MAAM,MAAM,GAAqB;gBAC/B,OAAO,EAAE;oBACP,KAAK,EAAE,UAAU;oBACjB,KAAK,EAAE,IAAA,wBAAa,EAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;iBAC1D;gBACD,IAAI,EAAE;oBACJ,KAAK,EAAE,SAAS;oBAChB,KAAK,EAAE,IAAA,wBAAa,EAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;iBACtD;gBACD,KAAK,EAAE;oBACL,KAAK,EAAE,UAAU;oBACjB,KAAK,EAAE,IAAA,wBAAa,EAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;iBACxD;gBACD,IAAI,EAAE;oBACJ,KAAK,EAAE,SAAS;oBAChB,KAAK,EAAE,IAAA,wBAAa,EAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;iBACtD;gBACD,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC;YAEF,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YACpB,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;YAE7B,IAAI,CAAC,GAAG,CAAC,KAAK,CACZ,gCAAgC,UAAU,KAAK,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK;kBACtE,QAAQ,SAAS,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK;kBAC5C,SAAS,UAAU,KAAK,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK;kBAC/C,QAAQ,SAAS,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAC7C,CAAC;YAEF,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI;kBAChF,gDAAgD,IAAI,CAAC,mBAAmB,EAAE,CAC7E,CAAC;YACF,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAED,oBAAoB;QAClB,IAAI,IAAI,CAAC,mBAAmB,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAhHD,sCAgHC"}

package/dist/settings.d.ts

@@ -0,0 +1,16 @@
+export declare const PLATFORM_NAME = "HomebridgePollen";
+export declare const PLUGIN_NAME = "homebridge-pollen";
+export declare const AMBEE_BASE_URL = "https://api.ambeedata.com";
+export declare const DEFAULT_POLL_INTERVAL = 60;
+export declare const MIN_POLL_INTERVAL = 15;
+export interface ThresholdRange {
+    low: number;
+    high: number;
+}
+export interface Thresholds {
+    overall: ThresholdRange;
+    tree: ThresholdRange;
+    grass: ThresholdRange;
+    weed: ThresholdRange;
+}
+export declare const DEFAULT_THRESHOLDS: Thresholds;

package/dist/settings.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_THRESHOLDS = exports.MIN_POLL_INTERVAL = exports.DEFAULT_POLL_INTERVAL = exports.AMBEE_BASE_URL = exports.PLUGIN_NAME = exports.PLATFORM_NAME = void 0;
+exports.PLATFORM_NAME = 'HomebridgePollen';
+exports.PLUGIN_NAME = 'homebridge-pollen';
+exports.AMBEE_BASE_URL = 'https://api.ambeedata.com';
+exports.DEFAULT_POLL_INTERVAL = 60; // minutes
+exports.MIN_POLL_INTERVAL = 15; // minutes
+exports.DEFAULT_THRESHOLDS = {
+    overall: { low: 50, high: 200 },
+    tree: { low: 15, high: 90 },
+    grass: { low: 20, high: 200 },
+    weed: { low: 10, high: 50 },
+};
+//# 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,QAAA,aAAa,GAAG,kBAAkB,CAAC;AACnC,QAAA,WAAW,GAAG,mBAAmB,CAAC;AAElC,QAAA,cAAc,GAAG,2BAA2B,CAAC;AAE7C,QAAA,qBAAqB,GAAG,EAAE,CAAC,CAAC,UAAU;AACtC,QAAA,iBAAiB,GAAG,EAAE,CAAC,CAAC,UAAU;AAclC,QAAA,kBAAkB,GAAe;IAC5C,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE;IAC/B,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAC3B,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE;IAC7B,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;CAC5B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+import type { PlatformConfig } from 'homebridge';
+import type { Thresholds } from './settings.js';
+export interface PollenConfig extends PlatformConfig {
+    apiKey: string;
+    location: string;
+    pollInterval?: number;
+    enableCategorySensors?: boolean;
+    enableAirQualitySensor?: boolean;
+    thresholds?: Partial<{
+        overall: Partial<{
+            low: number;
+            high: number;
+        }>;
+        tree: Partial<{
+            low: number;
+            high: number;
+        }>;
+        grass: Partial<{
+            low: number;
+            high: number;
+        }>;
+        weed: Partial<{
+            low: number;
+            high: number;
+        }>;
+    }>;
+}
+export interface AmbeePollenCount {
+    grass_pollen: number;
+    tree_pollen: number;
+    weed_pollen: number;
+}
+export interface AmbeePollenRisk {
+    grass_pollen: string;
+    tree_pollen: string;
+    weed_pollen: string;
+}
+export interface AmbeePollenSpecies {
+    Grass: Record<string, number>;
+    Tree: Record<string, number>;
+    Weed: Record<string, number>;
+}
+export interface AmbeePollenDataItem {
+    Count: AmbeePollenCount;
+    Risk: AmbeePollenRisk;
+    Species: AmbeePollenSpecies;
+    updatedAt: string;
+}
+export interface AmbeePollenResponse {
+    message: string;
+    data: AmbeePollenDataItem[];
+}
+export type PollenLevel = 'High' | 'Medium' | 'Low';
+export type PollenCategory = 'overall' | 'tree' | 'grass' | 'weed';
+export interface CategoryData {
+    count: number;
+    level: PollenLevel;
+}
+export interface ParsedPollenData {
+    overall: CategoryData;
+    tree: CategoryData;
+    grass: CategoryData;
+    weed: CategoryData;
+    timestamp: string;
+}
+export type AccessoryType = 'contact' | 'airquality';
+export interface AccessoryDefinition {
+    id: string;
+    name: string;
+    type: AccessoryType;
+    level?: PollenLevel;
+    category?: PollenCategory;
+}
+export declare function classifyLevel(count: number, thresholds: {
+    low: number;
+    high: number;
+}): PollenLevel;
+export declare function resolveThresholds(config: PollenConfig, defaults: Thresholds): Thresholds;

package/dist/types.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyLevel = classifyLevel;
+exports.resolveThresholds = resolveThresholds;
+function classifyLevel(count, thresholds) {
+    if (count >= thresholds.high) {
+        return 'High';
+    }
+    if (count <= thresholds.low) {
+        return 'Low';
+    }
+    return 'Medium';
+}
+function resolveThresholds(config, defaults) {
+    const overrides = config.thresholds;
+    if (!overrides) {
+        return defaults;
+    }
+    return {
+        overall: { ...defaults.overall, ...overrides.overall },
+        tree: { ...defaults.tree, ...overrides.tree },
+        grass: { ...defaults.grass, ...overrides.grass },
+        weed: { ...defaults.weed, ...overrides.weed },
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;AAyEA,sCAQC;AAED,8CAWC;AArBD,SAAgB,aAAa,CAAC,KAAa,EAAE,UAAyC;IACpF,IAAI,KAAK,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,iBAAiB,CAAC,MAAoB,EAAE,QAAoB;IAC1E,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC;IACpC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO;QACL,OAAO,EAAE,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE;QACtD,IAAI,EAAE,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE;QAC7C,KAAK,EAAE,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,SAAS,CAAC,KAAK,EAAE;QAChD,IAAI,EAAE,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE;KAC9C,CAAC;AACJ,CAAC"}

package/eslint.config.mjs

@@ -0,0 +1,10 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    ignores: ['dist/'],
+  },
+);

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "homebridge-pollen",
+  "version": "1.0.0",
+  "description": "Homebridge plugin that exposes pollen levels as HomeKit sensors using the Ambee API",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "engines": {
+    "node": ">=20.0.0",
+    "homebridge": "^1.8.0 || ^2.0.0"
+  },
+  "keywords": [
+    "homebridge",
+    "homebridge-plugin",
+    "pollen",
+    "allergy",
+    "allergies"
+  ],
+  "scripts": {
+    "build": "rimraf ./dist && tsc",
+    "lint": "eslint src/",
+    "setup": "bash scripts/setup.sh",
+    "dev": "npm run build && npm link && nodemon",
+    "prepare": "husky",
+    "prepublishOnly": "npm run lint && npm run build"
+  },
+  "lint-staged": {
+    "src/**/*.ts": "eslint"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.18.0",
+    "@types/node": "^20.19.30",
+    "eslint": "^9.18.0",
+    "homebridge": "^1.8.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "nodemon": "^3.1.9",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.21.0"
+  }
+}