homebridge-sonos-scenes 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 applemanj
+
+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,103 @@
+# homebridge-sonos-scenes
+
+`homebridge-sonos-scenes` is a Homebridge plugin scaffold for Sonos workflow scenes.
+
+The goal is not general Sonos control. The goal is a clean way to trigger multi-step Sonos workflows from Apple Home, such as:
+
+- grouping rooms around a coordinator,
+- selecting `line_in`, `favorite`, or transport-gated `tv` sources,
+- setting coordinator and per-room volume,
+- optionally ungrouping when the switch turns off.
+
+## What Is Implemented
+
+- A singular Homebridge dynamic platform plugin with switch accessories for each configured scene.
+- A normalized scene model that stores stable Sonos IDs instead of room-name strings.
+- A local-first `SonosTransport` abstraction with live discovery through the `sonos` package and fixture fallback for UI/testing.
+- A `SceneRunner` that validates scenes, serializes execution per coordinator, retries transient failures, and emits structured logs.
+- A Homebridge custom UI under `homebridge-ui/` with discovery, validation, test execution, and scene editing.
+- Sample fixture data and config examples for development without a live Sonos system.
+- Unit tests covering config normalization, validation, retry behavior, and off-action execution.
+
+## Project Layout
+
+```text
+src/
+  accessories/sceneSwitch.ts
+  config.ts
+  discoveryService.ts
+  index.ts
+  logger.ts
+  platform.ts
+  sampleTopology.ts
+  sceneRunner.ts
+  transports/
+  ui/serverApi.ts
+homebridge-ui/
+  public/index.html
+  server.js
+examples/
+  config.example.json
+  sample-topology.json
+test/
+```
+
+## Running It
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+For Homebridge development, point the plugin at a config shaped like [examples/config.example.json](examples/config.example.json).
+
+## Official Homebridge Test Path
+
+If you want to test it the normal Homebridge way, publish it to npm and install it from Homebridge by package name.
+
+This repo is set up for that flow now:
+
+- `prepare` builds `dist/` for Git-based installs.
+- `prepack` rebuilds `dist/` before `npm publish` so the published tarball contains runnable plugin files.
+- the published package includes `dist/`, `homebridge-ui/`, `config.schema.json`, and the example/docs assets listed in `package.json`.
+
+Typical release flow:
+
+```bash
+npm login
+npm test
+npm publish
+```
+
+After that, install `homebridge-sonos-scenes` from the Homebridge UI or via npm in the normal Homebridge plugin workflow.
+
+The Homebridge project’s verified-plugin guidance also expects the plugin to be published to npm with source available on GitHub:
+
+- Homebridge Verified Plugins: <https://github.com/homebridge/homebridge/wiki/verified-Plugins>
+
+## Transport Notes
+
+- The default transport is `local`.
+- Live discovery uses the community `sonos` package for local network discovery and control.
+- If live discovery fails, the plugin falls back to the configured fixture file or the built-in sample topology so the custom UI remains usable during development.
+- `tv` source loading is disabled by default and remains transport-gated.
+- Favorites rely on URIs exposed through the local transport; some complex favorite types may need more transport-specific handling later.
+
+## Official Sonos References
+
+These docs informed the product boundaries and future cloud-adapter shape:
+
+- Sonos Connected Home: <https://docs.sonos.com/docs/connected-home-get-started>
+- Sonos Authorize: <https://docs.sonos.com/docs/authorize>
+- Sonos Discover: <https://docs.sonos.com/docs/discover>
+- Sonos Control: <https://docs.sonos.com/docs/control>
+- Sonos Subscribe: <https://docs.sonos.com/docs/subscribe>
+- Sonos Features: <https://docs.sonos.com/docs/connected-home-features>
+- Homebridge plugin-ui-utils: <https://github.com/homebridge/plugin-ui-utils>
+
+## Current Gaps
+
+- The local transport is MVP-level and best-effort for advanced favorites and TV input handling.
+- Subscription-driven refresh is still represented by the transport abstraction, but not yet fully wired for live event propagation.
+- `npm audit` currently reports a high-severity advisory in the transitive `ip` dependency pulled in by `sonos`.

package/config.schema.json

@@ -0,0 +1,86 @@
+{
+  "pluginAlias": "SonosScenes",
+  "pluginType": "platform",
+  "singular": true,
+  "customUi": true,
+  "headerDisplay": "Discovery-driven Sonos workflow scenes for Homebridge.",
+  "footerDisplay": "Use the custom UI to discover players, validate scenes, and test execution.",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "default": "Sonos Scenes",
+        "required": true
+      },
+      "platform": {
+        "title": "Platform",
+        "type": "string",
+        "default": "SonosScenes",
+        "required": true
+      },
+      "logLevel": {
+        "title": "Log Level",
+        "type": "string",
+        "default": "info",
+        "oneOf": [
+          "debug",
+          "info",
+          "warn",
+          "error"
+        ]
+      },
+      "defaultHouseholdId": {
+        "title": "Default Household Id",
+        "type": "string"
+      },
+      "transport": {
+        "title": "Transport",
+        "type": "object",
+        "properties": {
+          "kind": {
+            "title": "Kind",
+            "type": "string",
+            "default": "local",
+            "oneOf": [
+              "local"
+            ]
+          },
+          "enableLiveDiscovery": {
+            "title": "Enable Live Discovery",
+            "type": "boolean",
+            "default": true
+          },
+          "fixturePath": {
+            "title": "Fixture Path",
+            "type": "string"
+          },
+          "discoveryTimeoutMs": {
+            "title": "Discovery Timeout (ms)",
+            "type": "integer",
+            "default": 2500
+          },
+          "requestTimeoutMs": {
+            "title": "Request Timeout (ms)",
+            "type": "integer",
+            "default": 5000
+          },
+          "allowTvSource": {
+            "title": "Allow TV Source",
+            "type": "boolean",
+            "default": false
+          }
+        }
+      },
+      "scenes": {
+        "title": "Scenes",
+        "type": "array",
+        "items": {
+          "type": "object"
+        },
+        "default": []
+      }
+    }
+  }
+}

package/dist/src/accessories/sceneSwitch.d.ts

@@ -0,0 +1,17 @@
+import type { PlatformAccessory } from "homebridge";
+import type { SceneDefinition } from "../types";
+import type { SonosScenesPlatform } from "../platform";
+export declare class SceneSwitchAccessory {
+    private readonly platform;
+    private readonly accessory;
+    private service;
+    private scene;
+    private onState;
+    private resetTimer?;
+    constructor(platform: SonosScenesPlatform, accessory: PlatformAccessory, scene: SceneDefinition);
+    updateScene(scene: SceneDefinition): void;
+    private handleOnGet;
+    private handleOnSet;
+    private armAutoReset;
+    private clearAutoReset;
+}

package/dist/src/accessories/sceneSwitch.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SceneSwitchAccessory = void 0;
+class SceneSwitchAccessory {
+    platform;
+    accessory;
+    service;
+    scene;
+    onState = false;
+    resetTimer;
+    constructor(platform, accessory, scene) {
+        this.platform = platform;
+        this.accessory = accessory;
+        this.scene = scene;
+        this.accessory.context.sceneId = scene.id;
+        this.accessory.displayName = scene.name;
+        this.service =
+            this.accessory.getService(this.platform.Service.Switch) ?? this.accessory.addService(this.platform.Service.Switch);
+        this.service.setCharacteristic(this.platform.Characteristic.Name, scene.name);
+        this.service.getCharacteristic(this.platform.Characteristic.On)
+            .onGet(this.handleOnGet.bind(this))
+            .onSet(this.handleOnSet.bind(this));
+        const accessoryInformation = this.accessory.getService(this.platform.Service.AccessoryInformation)
+            ?? this.accessory.addService(this.platform.Service.AccessoryInformation);
+        accessoryInformation
+            .setCharacteristic(this.platform.Characteristic.Manufacturer, "homebridge-sonos-scenes")
+            .setCharacteristic(this.platform.Characteristic.Model, "Sonos Scene Switch")
+            .setCharacteristic(this.platform.Characteristic.SerialNumber, scene.id);
+    }
+    updateScene(scene) {
+        this.scene = scene;
+        this.accessory.context.sceneId = scene.id;
+        this.accessory.displayName = scene.name;
+        this.service.setCharacteristic(this.platform.Characteristic.Name, scene.name);
+    }
+    handleOnGet() {
+        return this.onState;
+    }
+    async handleOnSet(value) {
+        const nextState = value === true;
+        if (nextState) {
+            const result = await this.platform.runScene(this.scene.id, "on");
+            if (!result.ok) {
+                this.onState = false;
+                this.service.updateCharacteristic(this.platform.Characteristic.On, false);
+                throw new Error(result.errors.join(" "));
+            }
+            this.onState = true;
+            this.service.updateCharacteristic(this.platform.Characteristic.On, true);
+            this.armAutoReset();
+            return;
+        }
+        const result = await this.platform.runScene(this.scene.id, "off");
+        if (!result.ok) {
+            throw new Error(result.errors.join(" "));
+        }
+        this.clearAutoReset();
+        this.onState = false;
+        this.service.updateCharacteristic(this.platform.Characteristic.On, false);
+    }
+    armAutoReset() {
+        this.clearAutoReset();
+        if (this.scene.autoResetMs <= 0) {
+            return;
+        }
+        this.resetTimer = setTimeout(() => {
+            this.onState = false;
+            this.service.updateCharacteristic(this.platform.Characteristic.On, false);
+            this.resetTimer = undefined;
+        }, this.scene.autoResetMs);
+    }
+    clearAutoReset() {
+        if (!this.resetTimer) {
+            return;
+        }
+        clearTimeout(this.resetTimer);
+        this.resetTimer = undefined;
+    }
+}
+exports.SceneSwitchAccessory = SceneSwitchAccessory;
+//# sourceMappingURL=sceneSwitch.js.map

package/dist/src/accessories/sceneSwitch.js.map

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

package/dist/src/config.d.ts

@@ -0,0 +1,7 @@
+import type { HouseholdSnapshot, SceneDefinition, SceneSourceKind, ScenesPlatformConfig, SonosTransport, TopologySnapshot, ValidationResult } from "./types";
+export declare function createDefaultPlatformConfig(): ScenesPlatformConfig;
+export declare function normalizeScene(scene: Partial<SceneDefinition>): SceneDefinition;
+export declare function normalizePlatformConfig(config: Partial<ScenesPlatformConfig> | undefined): ScenesPlatformConfig;
+export declare function findHousehold(snapshot: TopologySnapshot, householdId: string): HouseholdSnapshot | undefined;
+export declare function validateSceneDefinition(sceneInput: Partial<SceneDefinition>, snapshot: TopologySnapshot, transport: SonosTransport): ValidationResult;
+export declare function transportSourceKinds(transport: SonosTransport): SceneSourceKind[];

package/dist/src/config.js

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultPlatformConfig = createDefaultPlatformConfig;
+exports.normalizeScene = normalizeScene;
+exports.normalizePlatformConfig = normalizePlatformConfig;
+exports.findHousehold = findHousehold;
+exports.validateSceneDefinition = validateSceneDefinition;
+exports.transportSourceKinds = transportSourceKinds;
+const node_crypto_1 = require("node:crypto");
+const types_1 = require("./types");
+const DEFAULT_TRANSPORT = {
+    kind: "local",
+    enableLiveDiscovery: true,
+    discoveryTimeoutMs: 2500,
+    requestTimeoutMs: 5000,
+    allowTvSource: false,
+};
+function createDefaultPlatformConfig() {
+    return {
+        platform: types_1.PLATFORM_NAME,
+        name: "Sonos Scenes",
+        logLevel: "info",
+        transport: { ...DEFAULT_TRANSPORT },
+        scenes: [],
+    };
+}
+function slugify(value) {
+    const slug = value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || `scene-${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
+}
+function asNumber(value, fallback) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    return fallback;
+}
+function clampVolume(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return Math.max(0, Math.min(100, Math.round(value)));
+}
+function normalizeOffBehavior(value) {
+    if (typeof value === "object" && value !== null && "kind" in value && value.kind === "ungroup") {
+        return { kind: "ungroup" };
+    }
+    return { kind: "none" };
+}
+function normalizeSource(value) {
+    if (!value || typeof value !== "object" || !("kind" in value)) {
+        return undefined;
+    }
+    const input = value;
+    if (input.kind === "favorite") {
+        const favoriteId = String(input.favoriteId ?? "").trim();
+        if (!favoriteId) {
+            return undefined;
+        }
+        return {
+            kind: "favorite",
+            favoriteId,
+            favoriteName: typeof input.favoriteName === "string" ? input.favoriteName : undefined,
+        };
+    }
+    if (input.kind === "line_in") {
+        const deviceId = String(input.deviceId ?? "").trim();
+        if (!deviceId) {
+            return undefined;
+        }
+        return {
+            kind: "line_in",
+            deviceId,
+            deviceName: typeof input.deviceName === "string" ? input.deviceName : undefined,
+            playOnCompletion: input.playOnCompletion !== false,
+        };
+    }
+    if (input.kind === "tv") {
+        const deviceId = String(input.deviceId ?? "").trim();
+        if (!deviceId) {
+            return undefined;
+        }
+        return {
+            kind: "tv",
+            deviceId,
+            deviceName: typeof input.deviceName === "string" ? input.deviceName : undefined,
+            playOnCompletion: input.playOnCompletion !== false,
+        };
+    }
+    return undefined;
+}
+function normalizeScene(scene) {
+    const sceneName = String(scene.name ?? "New Scene").trim() || "New Scene";
+    return {
+        id: String(scene.id ?? "").trim() || slugify(sceneName),
+        name: sceneName,
+        householdId: String(scene.householdId ?? "").trim(),
+        coordinatorPlayerId: String(scene.coordinatorPlayerId ?? "").trim(),
+        memberPlayerIds: Array.isArray(scene.memberPlayerIds)
+            ? scene.memberPlayerIds.map((playerId) => String(playerId).trim()).filter(Boolean)
+            : [],
+        source: normalizeSource(scene.source),
+        coordinatorVolume: clampVolume(scene.coordinatorVolume === undefined ? undefined : asNumber(scene.coordinatorVolume, 0)),
+        playerVolumes: Array.isArray(scene.playerVolumes)
+            ? Array.from(new Map(scene.playerVolumes
+                .filter((volume) => volume && typeof volume.playerId === "string")
+                .map((volume) => [
+                volume.playerId,
+                {
+                    playerId: String(volume.playerId).trim(),
+                    volume: Math.max(0, Math.min(100, Math.round(asNumber(volume.volume, 0)))),
+                },
+            ])).values()).filter((volume) => volume.playerId.length > 0)
+            : [],
+        offBehavior: normalizeOffBehavior(scene.offBehavior),
+        settleMs: Math.max(0, asNumber(scene.settleMs, 750)),
+        retryCount: Math.max(0, asNumber(scene.retryCount, 3)),
+        retryDelayMs: Math.max(0, asNumber(scene.retryDelayMs, 750)),
+        autoResetMs: Math.max(0, asNumber(scene.autoResetMs, 1000)),
+    };
+}
+function normalizePlatformConfig(config) {
+    const defaults = createDefaultPlatformConfig();
+    const transport = {
+        ...DEFAULT_TRANSPORT,
+        ...(config?.transport ?? {}),
+        kind: "local",
+    };
+    return {
+        ...defaults,
+        ...config,
+        platform: types_1.PLATFORM_NAME,
+        name: String(config?.name ?? defaults.name).trim() || defaults.name,
+        logLevel: config?.logLevel === "debug" ||
+            config?.logLevel === "info" ||
+            config?.logLevel === "warn" ||
+            config?.logLevel === "error"
+            ? config.logLevel
+            : defaults.logLevel,
+        defaultHouseholdId: typeof config?.defaultHouseholdId === "string" ? config.defaultHouseholdId : undefined,
+        transport,
+        scenes: Array.isArray(config?.scenes) ? config.scenes.map((scene) => normalizeScene(scene)) : [],
+    };
+}
+function findHousehold(snapshot, householdId) {
+    return snapshot.households.find((household) => household.id === householdId);
+}
+function playerName(household, playerId) {
+    return household.players.find((player) => player.id === playerId)?.name ?? playerId;
+}
+function validateVolumes(scene, household, result) {
+    const referenced = new Set(household.players.map((player) => player.id));
+    if (scene.coordinatorVolume !== undefined && (scene.coordinatorVolume < 0 || scene.coordinatorVolume > 100)) {
+        result.errors.push("Coordinator volume must be between 0 and 100.");
+    }
+    for (const item of scene.playerVolumes) {
+        if (!referenced.has(item.playerId)) {
+            result.errors.push(`Per-room volume references an unknown player: ${item.playerId}.`);
+        }
+        if (item.volume < 0 || item.volume > 100) {
+            result.errors.push(`Volume for ${item.playerId} must be between 0 and 100.`);
+        }
+    }
+}
+function validateSource(scene, household, transport, result) {
+    const source = scene.source;
+    if (!source) {
+        return;
+    }
+    if (!transport.supportsSource(source.kind)) {
+        result.errors.push(`The active transport does not support source kind "${source.kind}".`);
+        return;
+    }
+    if (source.kind === "favorite") {
+        const favorite = household.favorites.find((item) => item.id === source.favoriteId);
+        if (!favorite) {
+            result.errors.push(`Favorite "${source.favoriteId}" was not found in household "${household.displayName}".`);
+        }
+        return;
+    }
+    const device = household.players.find((player) => player.id === source.deviceId);
+    if (!device) {
+        result.errors.push(`Source device "${source.deviceId}" was not found in household "${household.displayName}".`);
+        return;
+    }
+    if (!device.sourceOptions.includes(source.kind)) {
+        result.errors.push(`${device.name} does not advertise ${source.kind} as an available source.`);
+    }
+}
+function validateSceneDefinition(sceneInput, snapshot, transport) {
+    const scene = normalizeScene(sceneInput);
+    const result = {
+        valid: true,
+        errors: [],
+        warnings: [],
+    };
+    if (!scene.name.trim()) {
+        result.errors.push("Scene name is required.");
+    }
+    if (!scene.householdId.trim()) {
+        result.errors.push("Household selection is required.");
+    }
+    const household = findHousehold(snapshot, scene.householdId);
+    if (!household) {
+        result.errors.push(`Household "${scene.householdId}" was not found in the current topology.`);
+    }
+    if (!scene.coordinatorPlayerId.trim()) {
+        result.errors.push("Coordinator player selection is required.");
+    }
+    const duplicateMembers = scene.memberPlayerIds.filter((playerId, index, values) => values.indexOf(playerId) !== index);
+    if (duplicateMembers.length > 0) {
+        result.errors.push(`Scene members contain duplicates: ${Array.from(new Set(duplicateMembers)).join(", ")}.`);
+    }
+    if (scene.memberPlayerIds.includes(scene.coordinatorPlayerId)) {
+        result.errors.push("The coordinator cannot also appear in the grouped member list.");
+    }
+    if (household) {
+        const coordinator = household.players.find((player) => player.id === scene.coordinatorPlayerId);
+        if (!coordinator) {
+            result.errors.push(`Coordinator "${scene.coordinatorPlayerId}" was not found in "${household.displayName}".`);
+        }
+        for (const playerId of scene.memberPlayerIds) {
+            if (!household.players.some((player) => player.id === playerId)) {
+                result.errors.push(`Member "${playerId}" was not found in "${household.displayName}".`);
+            }
+        }
+        validateVolumes(scene, household, result);
+        validateSource(scene, household, transport, result);
+        if (scene.memberPlayerIds.length === 0) {
+            result.warnings.push("The scene has no member rooms selected, so only the coordinator room will be targeted.");
+        }
+        if (scene.offBehavior.kind === "ungroup" && scene.memberPlayerIds.length === 0) {
+            result.warnings.push("Off behavior is set to ungroup, but the scene does not include any grouped members.");
+        }
+        if (scene.coordinatorVolume === undefined && scene.playerVolumes.length === 0) {
+            result.warnings.push("No volume changes are configured. The scene will only affect grouping and source selection.");
+        }
+        if (scene.playerVolumes.some((volume) => volume.playerId === scene.coordinatorPlayerId)) {
+            result.warnings.push(`Per-room volume includes the coordinator (${playerName(household, scene.coordinatorPlayerId)}). Coordinator volume already has its own field.`);
+        }
+    }
+    result.valid = result.errors.length === 0;
+    return result;
+}
+function transportSourceKinds(transport) {
+    return ["favorite", "line_in", "tv"].filter((kind) => transport.supportsSource(kind));
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

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

package/dist/src/discoveryService.d.ts

@@ -0,0 +1,10 @@
+import type { HouseholdSnapshot, SonosHouseholdSummary, SonosTransport, TopologySnapshot } from "./types";
+export declare class DiscoveryService {
+    private readonly transport;
+    private lastSnapshot?;
+    constructor(transport: SonosTransport);
+    refresh(): Promise<TopologySnapshot>;
+    getSnapshot(): Promise<TopologySnapshot>;
+    getHouseholds(): Promise<SonosHouseholdSummary[]>;
+    findHousehold(snapshot: TopologySnapshot, householdId: string): HouseholdSnapshot | undefined;
+}

package/dist/src/discoveryService.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscoveryService = void 0;
+class DiscoveryService {
+    transport;
+    lastSnapshot;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async refresh() {
+        this.lastSnapshot = await this.transport.discoverTopology();
+        return this.lastSnapshot;
+    }
+    async getSnapshot() {
+        if (!this.lastSnapshot) {
+            return this.refresh();
+        }
+        return this.lastSnapshot;
+    }
+    async getHouseholds() {
+        const snapshot = await this.getSnapshot();
+        return snapshot.households.map((household) => ({
+            id: household.id,
+            displayName: household.displayName,
+        }));
+    }
+    findHousehold(snapshot, householdId) {
+        return snapshot.households.find((household) => household.id === householdId);
+    }
+}
+exports.DiscoveryService = DiscoveryService;
+//# sourceMappingURL=discoveryService.js.map

package/dist/src/discoveryService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discoveryService.js","sourceRoot":"","sources":["../../src/discoveryService.ts"],"names":[],"mappings":";;;AAEA,MAAa,gBAAgB;IAGE;IAFrB,YAAY,CAAoB;IAExC,YAA6B,SAAyB;QAAzB,cAAS,GAAT,SAAS,CAAgB;IAAG,CAAC;IAE1D,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,YAAY,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,OAAO,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAC7C,EAAE,EAAE,SAAS,CAAC,EAAE;YAChB,WAAW,EAAE,SAAS,CAAC,WAAW;SACnC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,aAAa,CAAC,QAA0B,EAAE,WAAmB;QAC3D,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;IAC/E,CAAC;CACF;AA7BD,4CA6BC"}

package/dist/src/index.d.ts

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

package/dist/src/index.js

@@ -0,0 +1,6 @@
+"use strict";
+const platform_1 = require("./platform");
+module.exports = (api) => {
+    api.registerPlatform(platform_1.PLUGIN_NAME, platform_1.PLATFORM_NAME, platform_1.SonosScenesPlatform);
+};
+//# sourceMappingURL=index.js.map