@pburtchaell/homebridge-seasons 0.0.1

package/.husky/pre-commit

@@ -0,0 +1 @@
+npm run lint && npm test

package/AGENTS.md

@@ -0,0 +1,5 @@
+# homebridge-seasons
+
+Homebridge plugin that exposes the current season as a custom HomeKit accessory.
+
+Uses npm. No build step—single-file CommonJS plugin.

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 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,44 @@
+# homebridge-seasons
+[![npm](https://img.shields.io/npm/v/@pburtchaell/homebridge-seasons.svg?style=flat-square)](https://www.npmjs.com/package/@pburtchaell/homebridge-seasons)
+[![npm](https://img.shields.io/npm/dt/@pburtchaell/homebridge-seasons.svg?style=flat-square)](https://www.npmjs.com/package/@pburtchaell/homebridge-seasons)
+[![GitHub last commit](https://img.shields.io/github/last-commit/pburtchaell/homebridge-seasons.svg?style=flat-square)](https://github.com/pburtchaell/homebridge-seasons)
+
+This is a plugin for [homebridge](https://github.com/homebridge/homebridge) that displays the current season of the year. You can download it via [npm](https://www.npmjs.com/package/@pburtchaell/homebridge-seasons).
+
+This project is a fork of the [original plugin](https://github.com/naofireblade/homebridge-seasons) by [Arne Blumentritt](https://github.com/naofireblade). Thanks to Arne for creating and maintaining this plugin.
+
+Feel free to leave any feedback [here](https://github.com/pburtchaell/homebridge-seasons/issues).
+
+## Features
+
+- Meteorologic season
+- Astronomic season
+- Nothern and southern hemisphere
+- Number and name representation of the season
+
+## Installation
+
+1. Install homebridge using: `npm install -g homebridge`
+2. Install this plugin using: `npm install -g @pburtchaell/homebridge-seasons`
+3. Update your configuration file. See the samples below.
+
+## Configuration
+
+Add the following information to your config file.
+
+- You can choose between the *meteorologic* and *astronomic* **calendar**.
+- You can set your **hemisphere** between *north* and *south*.
+- And you can decide whether you want to **display** the season as a *number* (0 = Spring), a *name* or *both*. The number representation can be used in homekit rules.
+
+
+```json
+"platforms": [
+	{
+		"platform": "Seasons",
+		"name": "Seasons",
+		"calendar": "meteorologic",
+		"hemisphere": "north",
+		"display": "both"
+	}
+]
+```

package/config.schema.json

@@ -0,0 +1,45 @@
+{
+  "pluginAlias": "Seasons",
+  "pluginType": "platform",
+  "singular": true,
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "default": "Seasons",
+        "required": true
+      },
+      "calendar": {
+        "title": "Calendar",
+        "type": "string",
+        "default": "meteorologic",
+        "description": "Astronomic uses the solstices and equinoxes for precise seasonal dates, while meteorologic uses fixed months like Dec-Feb for Winter, Mar-May for Spring, etc.",
+        "oneOf": [
+          { "title": "Meteorologic", "enum": ["meteorologic"] },
+          { "title": "Astronomic", "enum": ["astronomic"] }
+        ]
+      },
+      "hemisphere": {
+        "title": "Hemisphere",
+        "type": "string",
+        "default": "north",
+        "oneOf": [
+          { "title": "Northern", "enum": ["north"] },
+          { "title": "Southern", "enum": ["south"] }
+        ]
+      },
+      "display": {
+        "title": "Display",
+        "type": "string",
+        "default": "both",
+        "oneOf": [
+          { "title": "Both (number and name)", "enum": ["both"] },
+          { "title": "Number only", "enum": ["number"] },
+          { "title": "Name only", "enum": ["name"] }
+        ]
+      }
+    }
+  }
+}

package/index.js

@@ -0,0 +1,205 @@
+"use strict";
+
+const CustomUUID = {
+  SeasonService: "ca741310-c62e-454b-a63b-3a1db3ca2c3a",
+  SeasonCharacteristic: "9382ccde-6cab-42e7-877a-2df98b8d0b66",
+  SeasonNameCharacteristic: "02e4c0e3-44f9-44b8-8667-98f54b376ce4",
+};
+
+const Seasons = {
+  Spring: "Spring",
+  Summer: "Summer",
+  Autumn: "Autumn",
+  Winter: "Winter",
+};
+
+const SeasonNumber = {
+  [Seasons.Spring]: 0,
+  [Seasons.Summer]: 1,
+  [Seasons.Autumn]: 2,
+  [Seasons.Winter]: 3,
+};
+
+let Service;
+let Characteristic;
+let Formats;
+let Perms;
+let SeasonService;
+let SeasonCharacteristic;
+let SeasonNameCharacteristic;
+
+module.exports = function (homebridge) {
+  Service = homebridge.hap.Service;
+  Characteristic = homebridge.hap.Characteristic;
+  Formats = homebridge.hap.Formats;
+  Perms = homebridge.hap.Perms;
+
+  // Custom Season Service
+  SeasonService = class extends Service {
+    constructor(displayName, subtype) {
+      super(displayName, CustomUUID.SeasonService, subtype);
+    }
+  };
+
+  // Custom Season Characteristic (numeric value 0-3)
+  SeasonCharacteristic = class extends Characteristic {
+    constructor() {
+      super("Season", CustomUUID.SeasonCharacteristic);
+      this.setProps({
+        format: Formats.UINT8,
+        maxValue: 3,
+        minValue: 0,
+        minStep: 1,
+        perms: [Perms.READ, Perms.NOTIFY],
+      });
+      this.value = this.getDefaultValue();
+    }
+  };
+
+  // Custom Season Name Characteristic (string value)
+  SeasonNameCharacteristic = class extends Characteristic {
+    constructor() {
+      super("Season Name", CustomUUID.SeasonNameCharacteristic);
+      this.setProps({
+        format: Formats.STRING,
+        perms: [Perms.READ, Perms.NOTIFY],
+      });
+      this.value = this.getDefaultValue();
+    }
+  };
+
+  homebridge.registerPlatform("@pburtchaell/homebridge-seasons", "Seasons", SeasonsPlatform);
+};
+
+class SeasonsPlatform {
+  constructor(log, config) {
+    this.log = log;
+    this.config = config;
+  }
+
+  accessories(callback) {
+    const accessories = [];
+    accessories.push(new SeasonsAccessory(this));
+    callback(accessories);
+  }
+}
+
+class SeasonsAccessory {
+  constructor(platform) {
+    this.log = platform.log;
+    this.config = platform.config;
+    this.name = "Season";
+
+    // Get calendar type from config (default: meteorologic)
+    this.calendar = this.config.calendar || "meteorologic";
+
+    // Get hemisphere from config (default: north)
+    this.hemisphere = this.config.hemisphere || "north";
+
+    // Get display mode from config (default: both)
+    this.display = this.config.display || "both";
+
+    // Setup accessory information service
+    this.informationService = new Service.AccessoryInformation();
+    this.informationService
+      .setCharacteristic(Characteristic.Manufacturer, "Homebridge Seasons")
+      .setCharacteristic(Characteristic.Model, "Seasons Sensor")
+      .setCharacteristic(Characteristic.SerialNumber, "HB-SEASONS-001")
+      .setCharacteristic(Characteristic.FirmwareRevision, "1.0.0");
+
+    // Create season service and add characteristics depending on config
+    this.seasonService = new SeasonService(this.name);
+
+    if (this.display === "both" || this.display === "number") {
+      this.seasonService.addCharacteristic(SeasonCharacteristic);
+      this.seasonService
+        .getCharacteristic(SeasonCharacteristic)
+        .on("get", this.getCurrentSeason.bind(this));
+    }
+
+    if (this.display === "both" || this.display === "name") {
+      this.seasonService.addCharacteristic(SeasonNameCharacteristic);
+      this.seasonService
+        .getCharacteristic(SeasonNameCharacteristic)
+        .on("get", this.getCurrentSeasonName.bind(this));
+    }
+  }
+
+  identify(callback) {
+    this.log.debug("Identify requested");
+    callback();
+  }
+
+  getServices() {
+    return [this.informationService, this.seasonService];
+  }
+
+  getCurrentSeason(callback) {
+    this.getCurrentSeasonName((error, name) => {
+      callback(null, SeasonNumber[name]);
+    });
+  }
+
+  getCurrentSeasonName(callback) {
+    let season;
+
+    if (this.calendar === "meteorologic") {
+      this.log.debug("Using meteorologic calendar to get current season");
+      season = this.getMeteorologicSeason(new Date());
+    } else {
+      this.log.debug("Using astronomic calendar to get current season");
+      const northernHemisphere = this.hemisphere === "north";
+      this.log.debug("Hemisphere is " + (northernHemisphere ? "north" : "south"));
+      season = this.getAstronomicSeason(new Date(), northernHemisphere);
+    }
+
+    this.log.debug("Current season is " + season);
+    callback(null, season);
+  }
+
+  getMeteorologicSeason(date) {
+    const month = date.getMonth() + 1;
+
+    if (month >= 3 && month <= 5) { return Seasons.Spring; }
+    if (month >= 6 && month <= 8) { return Seasons.Summer; }
+    if (month >= 9 && month <= 11) { return Seasons.Autumn; }
+    return Seasons.Winter;
+  }
+
+  /**
+   * Calculate astronomical season based on solstices and equinoxes.
+   * Approximate dates (varies by ~1 day year to year):
+   * - Spring Equinox: March 20
+   * - Summer Solstice: June 21
+   * - Autumn Equinox: September 22
+   * - Winter Solstice: December 21
+   */
+  getAstronomicSeason(date, northernHemisphere) {
+    const month = date.getMonth() + 1;
+    const day = date.getDate();
+
+    let season;
+
+    if ((month === 3 && day >= 20) || month === 4 || month === 5 || (month === 6 && day < 21)) {
+      season = Seasons.Spring;
+    } else if ((month === 6 && day >= 21) || month === 7 || month === 8 || (month === 9 && day < 22)) {
+      season = Seasons.Summer;
+    } else if ((month === 9 && day >= 22) || month === 10 || month === 11 || (month === 12 && day < 21)) {
+      season = Seasons.Autumn;
+    } else {
+      season = Seasons.Winter;
+    }
+
+    if (!northernHemisphere) {
+      const opposite = {
+        [Seasons.Spring]: Seasons.Autumn,
+        [Seasons.Summer]: Seasons.Winter,
+        [Seasons.Autumn]: Seasons.Spring,
+        [Seasons.Winter]: Seasons.Summer,
+      };
+      season = opposite[season];
+    }
+
+    return season;
+  }
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "private": false,
+  "name": "@pburtchaell/homebridge-seasons",
+  "displayName": "Seasons",
+  "version": "0.0.1",
+  "description": "A plugin to display the current season of the year",
+  "license": "MIT",
+  "main": "index.js",
+  "keywords": [
+    "homebridge-plugin",
+    "season",
+    "seasons"
+  ],
+  "engines": {
+    "node": ">=20.0.0",
+    "homebridge": "^1.6.0 || ^2.0.0-beta.0"
+  },
+  "author": {
+    "name": "Patrick Burtchaell <patrick@pburtchaell.com> (pburtchaell.com)"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "lint": "eslint . --max-warnings=0",
+    "prepublishOnly": "npm run lint && npm test",
+    "prepare": "husky",
+    "dev": "npm link && nodemon"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/pburtchaell/homebridge-seasons.git"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.0.0",
+    "homebridge": "^2.0.0-beta.0",
+    "husky": "^9.1.7",
+    "nodemon": "^3.0.0",
+    "vitest": "^3.0.0"
+  }
+}

package/test/homebridge/accessories/cachedAccessories

@@ -0,0 +1 @@
+[]

package/test/homebridge/config.json

@@ -0,0 +1,17 @@
+{
+  "bridge": {
+    "name": "SeasonsDevBridge",
+    "username": "AA:BB:CC:DD:EE:FF",
+    "port": 51826,
+    "pin": "031-45-154"
+  },
+  "platforms": [
+    {
+      "name": "Seasons",
+      "platform": "Seasons",
+      "calendar": "meteorologic",
+      "hemisphere": "north",
+      "display": "both"
+    }
+  ]
+}

package/test/homebridge/persist/AccessoryInfo.AABBCCDDEEFF.json

@@ -0,0 +1 @@
+{"displayName":"SeasonsDevBridge 702C","category":2,"pincode":"031-45-154","signSk":"76a5e4a5c24fd5003d9ad0faf10caffb82e399c68e6f8d6c613903da57b797af9a6304ad55a8a83f0da6e37abb61dd459416517000f62e820574d75599926828","signPk":"9a6304ad55a8a83f0da6e37abb61dd459416517000f62e820574d75599926828","pairedClients":{},"pairedClientsPermission":{},"configVersion":2,"configHash":"8c7eda26fad8d979384af44d65715bf904f5558d","setupID":"OXVI","lastFirmwareVersion":"0.11.2"}

package/test/homebridge/persist/IdentifierCache.AABBCCDDEEFF.json

@@ -0,0 +1 @@
+{"cache":{"f6f986a8-ae40-4f38-aa34-4b232ed91fca|nextIID":10,"f6f986a8-ae40-4f38-aa34-4b232ed91fca|0000003E-0000-1000-8000-0026BB765291|00000014-0000-1000-8000-0026BB765291":2,"f6f986a8-ae40-4f38-aa34-4b232ed91fca|0000003E-0000-1000-8000-0026BB765291|00000020-0000-1000-8000-0026BB765291":3,"f6f986a8-ae40-4f38-aa34-4b232ed91fca|0000003E-0000-1000-8000-0026BB765291|00000021-0000-1000-8000-0026BB765291":4,"f6f986a8-ae40-4f38-aa34-4b232ed91fca|0000003E-0000-1000-8000-0026BB765291|00000023-0000-1000-8000-0026BB765291":5,"f6f986a8-ae40-4f38-aa34-4b232ed91fca|0000003E-0000-1000-8000-0026BB765291|00000030-0000-1000-8000-0026BB765291":6,"f6f986a8-ae40-4f38-aa34-4b232ed91fca|0000003E-0000-1000-8000-0026BB765291|00000052-0000-1000-8000-0026BB765291":7,"f6f986a8-ae40-4f38-aa34-4b232ed91fca|000000A2-0000-1000-8000-0026BB765291":8,"f6f986a8-ae40-4f38-aa34-4b232ed91fca|000000A2-0000-1000-8000-0026BB765291|00000037-0000-1000-8000-0026BB765291":9,"|nextAID":3,"25ec2c37-426c-4b8e-a20f-976770fa1af5":2,"25ec2c37-426c-4b8e-a20f-976770fa1af5|nextIID":12,"25ec2c37-426c-4b8e-a20f-976770fa1af5|0000003E-0000-1000-8000-0026BB765291|00000014-0000-1000-8000-0026BB765291":2,"25ec2c37-426c-4b8e-a20f-976770fa1af5|0000003E-0000-1000-8000-0026BB765291|00000020-0000-1000-8000-0026BB765291":3,"25ec2c37-426c-4b8e-a20f-976770fa1af5|0000003E-0000-1000-8000-0026BB765291|00000021-0000-1000-8000-0026BB765291":4,"25ec2c37-426c-4b8e-a20f-976770fa1af5|0000003E-0000-1000-8000-0026BB765291|00000023-0000-1000-8000-0026BB765291":5,"25ec2c37-426c-4b8e-a20f-976770fa1af5|0000003E-0000-1000-8000-0026BB765291|00000030-0000-1000-8000-0026BB765291":6,"25ec2c37-426c-4b8e-a20f-976770fa1af5|0000003E-0000-1000-8000-0026BB765291|00000052-0000-1000-8000-0026BB765291":7,"25ec2c37-426c-4b8e-a20f-976770fa1af5|ca741310-c62e-454b-a63b-3a1db3ca2c3a":8,"25ec2c37-426c-4b8e-a20f-976770fa1af5|ca741310-c62e-454b-a63b-3a1db3ca2c3a|00000023-0000-1000-8000-0026BB765291":9,"25ec2c37-426c-4b8e-a20f-976770fa1af5|ca741310-c62e-454b-a63b-3a1db3ca2c3a|9382ccde-6cab-42e7-877a-2df98b8d0b66":10,"25ec2c37-426c-4b8e-a20f-976770fa1af5|ca741310-c62e-454b-a63b-3a1db3ca2c3a|02e4c0e3-44f9-44b8-8667-98f54b376ce4":11}}

package/test/index.test.js

@@ -0,0 +1,250 @@
+// --- Mock Homebridge HAP API ---
+
+function createHomebridgeMock() {
+  class MockCharacteristic {
+    constructor(name, uuid) {
+      this.displayName = name;
+      this.UUID = uuid;
+      this.value = null;
+      this._props = {};
+      this._handlers = {};
+    }
+    setProps(props) {
+      this._props = props;
+      return this;
+    }
+    getDefaultValue() {
+      return null;
+    }
+    on(event, handler) {
+      this._handlers[event] = handler;
+      return this;
+    }
+  }
+
+  MockCharacteristic.Formats = { UINT8: "uint8", STRING: "string" };
+  MockCharacteristic.Perms = { READ: "pr", NOTIFY: "ev" };
+  MockCharacteristic.Manufacturer = "manufacturer";
+  MockCharacteristic.Model = "model";
+  MockCharacteristic.SerialNumber = "serialnumber";
+  MockCharacteristic.FirmwareRevision = "firmwarerevision";
+
+  class MockService {
+    constructor(displayName, uuid, subtype) {
+      this.displayName = displayName;
+      this.UUID = uuid;
+      this.subtype = subtype;
+      this._characteristics = new Map();
+    }
+    addCharacteristic(CharClass) {
+      const inst = new CharClass();
+      this._characteristics.set(CharClass, inst);
+      return inst;
+    }
+    getCharacteristic(key) {
+      if (this._characteristics.has(key)) {
+        return this._characteristics.get(key);
+      }
+      return this;
+    }
+    setCharacteristic() {
+      return this;
+    }
+  }
+
+  MockService.AccessoryInformation = class extends MockService {
+    constructor() {
+      super("Accessory Information", "0000003E-0000-1000-8000-0026BB765291");
+    }
+  };
+
+  let PlatformClass = null;
+
+  return {
+    hap: {
+      Service: MockService,
+      Characteristic: MockCharacteristic,
+      Formats: { UINT8: "uint8", STRING: "string" },
+      Perms: { READ: "pr", NOTIFY: "ev" },
+    },
+    registerPlatform(id, name, cls) {
+      PlatformClass = cls;
+    },
+    get PlatformClass() {
+      return PlatformClass;
+    },
+  };
+}
+
+// --- Setup ---
+
+const mock = createHomebridgeMock();
+require("../index")(mock);
+
+function createAccessory(config = {}) {
+  const defaults = {
+    name: "Seasons",
+    platform: "Seasons",
+    calendar: "meteorologic",
+    hemisphere: "north",
+    display: "both",
+  };
+  const log = Object.assign(() => {}, { debug() {} });
+  const platform = new mock.PlatformClass(log, { ...defaults, ...config });
+  let accessory;
+  platform.accessories((accs) => {
+    accessory = accs[0];
+  });
+  return accessory;
+}
+
+function date(month, day) {
+  return new Date(2025, month - 1, day);
+}
+
+// --- Tests ---
+
+describe("Meteorologic seasons", () => {
+  const accessory = createAccessory({ calendar: "meteorologic" });
+
+  const cases = [
+    [1, "Winter"],
+    [2, "Winter"],
+    [3, "Spring"],
+    [4, "Spring"],
+    [5, "Spring"],
+    [6, "Summer"],
+    [7, "Summer"],
+    [8, "Summer"],
+    [9, "Autumn"],
+    [10, "Autumn"],
+    [11, "Autumn"],
+    [12, "Winter"],
+  ];
+
+  for (const [month, expected] of cases) {
+    it(`month ${month} → ${expected}`, () => {
+      expect(accessory.getMeteorologicSeason(date(month, 15))).toBe(expected);
+    });
+  }
+});
+
+describe("Astronomic seasons (northern hemisphere)", () => {
+  const accessory = createAccessory({
+    calendar: "astronomic",
+    hemisphere: "north",
+  });
+
+  const cases = [
+    // Spring equinox boundary (Mar 20)
+    [3, 19, "Winter"],
+    [3, 20, "Spring"],
+    [3, 21, "Spring"],
+    // Summer solstice boundary (Jun 21)
+    [6, 20, "Spring"],
+    [6, 21, "Summer"],
+    [6, 22, "Summer"],
+    // Autumn equinox boundary (Sep 22)
+    [9, 21, "Summer"],
+    [9, 22, "Autumn"],
+    [9, 23, "Autumn"],
+    // Winter solstice boundary (Dec 21)
+    [12, 20, "Autumn"],
+    [12, 21, "Winter"],
+    [12, 22, "Winter"],
+    // Mid-season checks
+    [1, 15, "Winter"],
+    [4, 15, "Spring"],
+    [7, 15, "Summer"],
+    [10, 15, "Autumn"],
+  ];
+
+  for (const [month, day, expected] of cases) {
+    it(`${month}/${day} → ${expected}`, () => {
+      expect(accessory.getAstronomicSeason(date(month, day), true)).toBe(
+        expected,
+      );
+    });
+  }
+});
+
+describe("Astronomic seasons (southern hemisphere)", () => {
+  const accessory = createAccessory({
+    calendar: "astronomic",
+    hemisphere: "south",
+  });
+
+  const cases = [
+    // Hemisphere inversion: north season → opposite in south
+    [1, 15, "Summer"],
+    [4, 15, "Autumn"],
+    [7, 15, "Winter"],
+    [10, 15, "Spring"],
+    // Boundaries also flip
+    [3, 19, "Summer"],
+    [3, 20, "Autumn"],
+    [6, 21, "Winter"],
+    [9, 22, "Spring"],
+    [12, 21, "Summer"],
+  ];
+
+  for (const [month, day, expected] of cases) {
+    it(`${month}/${day} → ${expected}`, () => {
+      expect(accessory.getAstronomicSeason(date(month, day), false)).toBe(
+        expected,
+      );
+    });
+  }
+});
+
+describe("Config integration", () => {
+  it("applies default config values", () => {
+    const accessory = createAccessory({});
+    expect(accessory.calendar).toBe("meteorologic");
+    expect(accessory.hemisphere).toBe("north");
+    expect(accessory.display).toBe("both");
+  });
+
+  it("getCurrentSeason returns number matching season name", () => {
+    return new Promise((resolve) => {
+      const accessory = createAccessory({ calendar: "meteorologic" });
+      accessory.getCurrentSeasonName((err, name) => {
+        accessory.getCurrentSeason((err2, number) => {
+          const seasonNumbers = { Spring: 0, Summer: 1, Autumn: 2, Winter: 3 };
+          expect(number).toBe(seasonNumbers[name]);
+          resolve();
+        });
+      });
+    });
+  });
+});
+
+describe("Display mode wiring", () => {
+  it("'both' registers number and name characteristics", () => {
+    const accessory = createAccessory({ display: "both" });
+    expect(accessory.seasonService._characteristics.size).toBe(2);
+
+    // Both should have get handlers
+    for (const [, char] of accessory.seasonService._characteristics) {
+      expect(typeof char._handlers.get).toBe("function");
+    }
+  });
+
+  it("'number' registers only the numeric characteristic", () => {
+    const accessory = createAccessory({ display: "number" });
+    expect(accessory.seasonService._characteristics.size).toBe(1);
+
+    const [, char] = [...accessory.seasonService._characteristics][0];
+    expect(char.UUID).toBe("9382ccde-6cab-42e7-877a-2df98b8d0b66");
+    expect(typeof char._handlers.get).toBe("function");
+  });
+
+  it("'name' registers only the name characteristic", () => {
+    const accessory = createAccessory({ display: "name" });
+    expect(accessory.seasonService._characteristics.size).toBe(1);
+
+    const [, char] = [...accessory.seasonService._characteristics][0];
+    expect(char.UUID).toBe("02e4c0e3-44f9-44b8-8667-98f54b376ce4");
+    expect(typeof char._handlers.get).toBe("function");
+  });
+});

package/vitest.config.js

@@ -0,0 +1,7 @@
+const { defineConfig } = require("vitest/config");
+
+module.exports = defineConfig({
+  test: {
+    globals: true,
+  },
+});