homebridge-sonos-scenes 0.1.0

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,yCAA6E;AAE7E,iBAAS,CAAC,GAAQ,EAAE,EAAE;IACpB,GAAG,CAAC,gBAAgB,CAAC,sBAAW,EAAE,wBAAa,EAAE,8BAAmB,CAAC,CAAC;AACxE,CAAC,CAAC"}

package/dist/src/logger.d.ts

@@ -0,0 +1,23 @@
+import type { Logger as HomebridgeLogger } from "homebridge";
+import type { LogLevel, SceneLogEntry } from "./types";
+export interface LogCollector {
+    entries: SceneLogEntry[];
+    push(entry: SceneLogEntry): void;
+}
+export declare class MemoryLogCollector implements LogCollector {
+    readonly entries: SceneLogEntry[];
+    push(entry: SceneLogEntry): void;
+}
+export declare class StructuredLogger {
+    private readonly scope;
+    private readonly level;
+    private readonly homebridgeLog?;
+    private readonly collector?;
+    constructor(scope: string, level: LogLevel, homebridgeLog?: HomebridgeLogger | undefined, collector?: LogCollector | undefined);
+    child(scope: string): StructuredLogger;
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    private log;
+}

package/dist/src/logger.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StructuredLogger = exports.MemoryLogCollector = void 0;
+const severity = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+class MemoryLogCollector {
+    entries = [];
+    push(entry) {
+        this.entries.push(entry);
+    }
+}
+exports.MemoryLogCollector = MemoryLogCollector;
+class StructuredLogger {
+    scope;
+    level;
+    homebridgeLog;
+    collector;
+    constructor(scope, level, homebridgeLog, collector) {
+        this.scope = scope;
+        this.level = level;
+        this.homebridgeLog = homebridgeLog;
+        this.collector = collector;
+    }
+    child(scope) {
+        return new StructuredLogger(`${this.scope}:${scope}`, this.level, this.homebridgeLog, this.collector);
+    }
+    debug(message) {
+        this.log("debug", message);
+    }
+    info(message) {
+        this.log("info", message);
+    }
+    warn(message) {
+        this.log("warn", message);
+    }
+    error(message) {
+        this.log("error", message);
+    }
+    log(level, message) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            scope: this.scope,
+            message,
+        };
+        this.collector?.push(entry);
+        if (severity[level] < severity[this.level] || !this.homebridgeLog) {
+            return;
+        }
+        if (level === "debug") {
+            this.homebridgeLog.debug(`[${this.scope}] ${message}`);
+            return;
+        }
+        if (level === "info") {
+            this.homebridgeLog.info(`[${this.scope}] ${message}`);
+            return;
+        }
+        if (level === "warn") {
+            this.homebridgeLog.warn(`[${this.scope}] ${message}`);
+            return;
+        }
+        this.homebridgeLog.error(`[${this.scope}] ${message}`);
+    }
+}
+exports.StructuredLogger = StructuredLogger;
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":";;;AAGA,MAAM,QAAQ,GAA6B;IACzC,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAC;AAOF,MAAa,kBAAkB;IACb,OAAO,GAAoB,EAAE,CAAC;IAE9C,IAAI,CAAC,KAAoB;QACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;CACF;AAND,gDAMC;AAED,MAAa,gBAAgB;IAER;IACA;IACA;IACA;IAJnB,YACmB,KAAa,EACb,KAAe,EACf,aAAgC,EAChC,SAAwB;QAHxB,UAAK,GAAL,KAAK,CAAQ;QACb,UAAK,GAAL,KAAK,CAAU;QACf,kBAAa,GAAb,aAAa,CAAmB;QAChC,cAAS,GAAT,SAAS,CAAe;IACxC,CAAC;IAEJ,KAAK,CAAC,KAAa;QACjB,OAAO,IAAI,gBAAgB,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACxG,CAAC;IAED,KAAK,CAAC,OAAe;QACnB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAe;QACnB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe;QAC1C,MAAM,KAAK,GAAkB;YAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO;SACR,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAE5B,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YAClE,OAAO;QACT,CAAC;QAED,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QAED,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YACrB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QAED,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YACrB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;CACF;AA3DD,4CA2DC"}

package/dist/src/platform.d.ts

@@ -0,0 +1,23 @@
+import type { API, DynamicPlatformPlugin, Logger, PlatformAccessory, PlatformConfig } from "homebridge";
+import type { SceneDefinition, SceneRunResult, SceneTrigger } from "./types";
+import { PLATFORM_NAME, PLUGIN_NAME } from "./types";
+export { PLATFORM_NAME, PLUGIN_NAME };
+export declare class SonosScenesPlatform implements DynamicPlatformPlugin {
+    readonly log: Logger;
+    private readonly rawConfig;
+    readonly api: API;
+    readonly Service: typeof import("homebridge").Service;
+    readonly Characteristic: typeof import("homebridge").Characteristic;
+    private readonly config;
+    private readonly logger;
+    private readonly discoveryService;
+    private readonly sceneRunner;
+    private readonly transport;
+    private readonly cachedAccessories;
+    private readonly sceneAccessories;
+    constructor(log: Logger, rawConfig: PlatformConfig, api: API);
+    configureAccessory(accessory: PlatformAccessory): void;
+    runScene(sceneId: string, trigger: SceneTrigger): Promise<SceneRunResult>;
+    getScene(sceneId: string): SceneDefinition | undefined;
+    private syncAccessories;
+}

package/dist/src/platform.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SonosScenesPlatform = exports.PLUGIN_NAME = exports.PLATFORM_NAME = void 0;
+const config_1 = require("./config");
+const discoveryService_1 = require("./discoveryService");
+const logger_1 = require("./logger");
+const sceneRunner_1 = require("./sceneRunner");
+const sceneSwitch_1 = require("./accessories/sceneSwitch");
+const transports_1 = require("./transports");
+const types_1 = require("./types");
+Object.defineProperty(exports, "PLATFORM_NAME", { enumerable: true, get: function () { return types_1.PLATFORM_NAME; } });
+Object.defineProperty(exports, "PLUGIN_NAME", { enumerable: true, get: function () { return types_1.PLUGIN_NAME; } });
+class SonosScenesPlatform {
+    log;
+    rawConfig;
+    api;
+    Service;
+    Characteristic;
+    config;
+    logger;
+    discoveryService;
+    sceneRunner;
+    transport;
+    cachedAccessories = new Map();
+    sceneAccessories = new Map();
+    constructor(log, rawConfig, api) {
+        this.log = log;
+        this.rawConfig = rawConfig;
+        this.api = api;
+        this.Service = this.api.hap.Service;
+        this.Characteristic = this.api.hap.Characteristic;
+        this.config = (0, config_1.normalizePlatformConfig)(rawConfig);
+        this.transport = (0, transports_1.createTransport)(this.config);
+        this.logger = new logger_1.StructuredLogger("platform", this.config.logLevel, this.log);
+        this.discoveryService = new discoveryService_1.DiscoveryService(this.transport);
+        this.sceneRunner = new sceneRunner_1.SceneRunner(this.discoveryService, this.transport, this.logger);
+        this.api.on("didFinishLaunching", () => {
+            void this.syncAccessories();
+        });
+    }
+    configureAccessory(accessory) {
+        this.cachedAccessories.set(accessory.UUID, accessory);
+    }
+    async runScene(sceneId, trigger) {
+        const scene = this.config.scenes.find((item) => item.id === sceneId);
+        if (!scene) {
+            return {
+                ok: false,
+                sceneId,
+                trigger,
+                logs: [],
+                errors: [`Scene "${sceneId}" is not configured.`],
+            };
+        }
+        if (trigger === "off") {
+            return this.sceneRunner.runOff(scene);
+        }
+        if (trigger === "test") {
+            return this.sceneRunner.runTest(scene);
+        }
+        return this.sceneRunner.runOn(scene);
+    }
+    getScene(sceneId) {
+        return this.config.scenes.find((scene) => scene.id === sceneId);
+    }
+    async syncAccessories() {
+        this.logger.info(`Syncing ${this.config.scenes.length} configured Sonos scene accessory(s).`);
+        const activeAccessoryIds = new Set();
+        for (const scene of this.config.scenes) {
+            const uuid = this.api.hap.uuid.generate(`${types_1.PLUGIN_NAME}:${scene.id}`);
+            activeAccessoryIds.add(uuid);
+            let accessory = this.cachedAccessories.get(uuid);
+            if (!accessory) {
+                accessory = new this.api.platformAccessory(scene.name, uuid);
+                this.cachedAccessories.set(uuid, accessory);
+                const wrapper = new sceneSwitch_1.SceneSwitchAccessory(this, accessory, scene);
+                this.sceneAccessories.set(scene.id, wrapper);
+                this.api.registerPlatformAccessories(types_1.PLUGIN_NAME, types_1.PLATFORM_NAME, [accessory]);
+                continue;
+            }
+            const wrapper = this.sceneAccessories.get(scene.id) ?? new sceneSwitch_1.SceneSwitchAccessory(this, accessory, scene);
+            wrapper.updateScene(scene);
+            this.sceneAccessories.set(scene.id, wrapper);
+            this.api.updatePlatformAccessories([accessory]);
+        }
+        const staleAccessories = Array.from(this.cachedAccessories.entries())
+            .filter(([uuid]) => !activeAccessoryIds.has(uuid))
+            .map(([, accessory]) => accessory);
+        if (staleAccessories.length > 0) {
+            this.api.unregisterPlatformAccessories(types_1.PLUGIN_NAME, types_1.PLATFORM_NAME, staleAccessories);
+            for (const accessory of staleAccessories) {
+                this.cachedAccessories.delete(accessory.UUID);
+            }
+            for (const [sceneId, wrapper] of this.sceneAccessories.entries()) {
+                if (!this.config.scenes.some((scene) => scene.id === sceneId)) {
+                    void wrapper;
+                    this.sceneAccessories.delete(sceneId);
+                }
+            }
+        }
+        try {
+            const snapshot = await this.discoveryService.refresh();
+            this.logger.info(`Discovery complete: ${snapshot.households.length} household(s) available.`);
+        }
+        catch (error) {
+            this.logger.warn(`Initial discovery failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+exports.SonosScenesPlatform = SonosScenesPlatform;
+//# sourceMappingURL=platform.js.map

package/dist/src/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/platform.ts"],"names":[],"mappings":";;;AACA,qCAAmD;AACnD,yDAAsD;AACtD,qCAA4C;AAC5C,+CAA4C;AAC5C,2DAAiE;AACjE,6CAA+C;AAE/C,mCAAqD;AAE5C,8FAFA,qBAAa,OAEA;AAAE,4FAFA,mBAAW,OAEA;AAEnC,MAAa,mBAAmB;IAaZ;IACC;IACD;IAdF,OAAO,CAAC;IACR,cAAc,CAAC;IAEd,MAAM,CAAuB;IAC7B,MAAM,CAAmB;IACzB,gBAAgB,CAAmB;IACnC,WAAW,CAAc;IACzB,SAAS,CAAC;IACV,iBAAiB,GAAG,IAAI,GAAG,EAA6B,CAAC;IACzD,gBAAgB,GAAG,IAAI,GAAG,EAAgC,CAAC;IAE5E,YACkB,GAAW,EACV,SAAyB,EAC1B,GAAQ;QAFR,QAAG,GAAH,GAAG,CAAQ;QACV,cAAS,GAAT,SAAS,CAAgB;QAC1B,QAAG,GAAH,GAAG,CAAK;QAExB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;QACpC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAA,gCAAuB,EAAC,SAA0C,CAAC,CAAC;QAClF,IAAI,CAAC,SAAS,GAAG,IAAA,4BAAe,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,yBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/E,IAAI,CAAC,gBAAgB,GAAG,IAAI,mCAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,CAAC,WAAW,GAAG,IAAI,yBAAW,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEvF,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;YACrC,KAAK,IAAI,CAAC,eAAe,EAAE,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB,CAAC,SAA4B;QAC7C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,OAAqB;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO;gBACP,OAAO;gBACP,IAAI,EAAE,EAAE;gBACR,MAAM,EAAE,CAAC,UAAU,OAAO,sBAAsB,CAAC;aAClD,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ,CAAC,OAAe;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAClE,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,uCAAuC,CAAC,CAAC;QAC9F,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE7C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,mBAAW,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACtE,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEjD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC7D,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAC5C,MAAM,OAAO,GAAG,IAAI,kCAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;gBACjE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBAC7C,IAAI,CAAC,GAAG,CAAC,2BAA2B,CAAC,mBAAW,EAAE,qBAAa,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC9E,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,IAAI,kCAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YACxG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAC3B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAC7C,IAAI,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;aAClE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;aACjD,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;QAErC,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,6BAA6B,CAAC,mBAAW,EAAE,qBAAa,EAAE,gBAAgB,CAAC,CAAC;YACrF,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;gBACzC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAChD,CAAC;YACD,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC;gBACjE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC;oBAC9D,KAAK,OAAO,CAAC;oBACb,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,QAAQ,CAAC,UAAU,CAAC,MAAM,0BAA0B,CAAC,CAAC;QAChG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1G,CAAC;IACH,CAAC;CACF;AA7GD,kDA6GC"}

package/dist/src/sampleTopology.d.ts

@@ -0,0 +1,2 @@
+import type { TopologySnapshot } from "./types";
+export declare const sampleTopology: TopologySnapshot;

package/dist/src/sampleTopology.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sampleTopology = void 0;
+exports.sampleTopology = {
+    capturedAt: "2026-04-18T00:00:00.000Z",
+    origin: "fixture",
+    households: [
+        {
+            id: "local-household",
+            displayName: "Local Sonos",
+            players: [
+                {
+                    id: "RINCON_UPPER_LEVEL",
+                    name: "Upper Level",
+                    model: "Sonos Amp",
+                    capabilities: ["PLAYBACK", "LINE_IN", "AIRPLAY"],
+                    deviceIds: ["RINCON_UPPER_LEVEL"],
+                    groupId: "GROUP_UPPER_LEVEL",
+                    isCoordinator: true,
+                    fixedVolume: false,
+                    sourceOptions: ["line_in", "favorite"],
+                },
+                {
+                    id: "RINCON_PRIMARY_BEDROOM",
+                    name: "Primary Bedroom",
+                    model: "Sonos Beam",
+                    capabilities: ["PLAYBACK", "AIRPLAY"],
+                    deviceIds: ["RINCON_PRIMARY_BEDROOM"],
+                    groupId: "GROUP_PRIMARY_BEDROOM",
+                    isCoordinator: true,
+                    fixedVolume: false,
+                    sourceOptions: ["favorite"],
+                },
+            ],
+            groups: [
+                {
+                    id: "GROUP_UPPER_LEVEL",
+                    name: "Upper Level",
+                    coordinatorId: "RINCON_UPPER_LEVEL",
+                    playerIds: ["RINCON_UPPER_LEVEL"],
+                    playbackState: "PLAYBACK_STATE_IDLE",
+                },
+                {
+                    id: "GROUP_PRIMARY_BEDROOM",
+                    name: "Primary Bedroom",
+                    coordinatorId: "RINCON_PRIMARY_BEDROOM",
+                    playerIds: ["RINCON_PRIMARY_BEDROOM"],
+                    playbackState: "PLAYBACK_STATE_IDLE",
+                },
+            ],
+            favorites: [
+                {
+                    id: "favorite-line-in-demo",
+                    name: "Line-In Demo",
+                    uri: "x-sonosapi-stream:s123?sid=254&flags=8224&sn=0",
+                },
+                {
+                    id: "favorite-kexp",
+                    name: "KEXP",
+                    uri: "x-sonosapi-stream:s21606?sid=254&flags=8224&sn=0",
+                },
+            ],
+        },
+    ],
+};
+//# sourceMappingURL=sampleTopology.js.map

package/dist/src/sampleTopology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampleTopology.js","sourceRoot":"","sources":["../../src/sampleTopology.ts"],"names":[],"mappings":";;;AAEa,QAAA,cAAc,GAAqB;IAC9C,UAAU,EAAE,0BAA0B;IACtC,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE;QACV;YACE,EAAE,EAAE,iBAAiB;YACrB,WAAW,EAAE,aAAa;YAC1B,OAAO,EAAE;gBACP;oBACE,EAAE,EAAE,oBAAoB;oBACxB,IAAI,EAAE,aAAa;oBACnB,KAAK,EAAE,WAAW;oBAClB,YAAY,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC;oBAChD,SAAS,EAAE,CAAC,oBAAoB,CAAC;oBACjC,OAAO,EAAE,mBAAmB;oBAC5B,aAAa,EAAE,IAAI;oBACnB,WAAW,EAAE,KAAK;oBAClB,aAAa,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;iBACvC;gBACD;oBACE,EAAE,EAAE,wBAAwB;oBAC5B,IAAI,EAAE,iBAAiB;oBACvB,KAAK,EAAE,YAAY;oBACnB,YAAY,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;oBACrC,SAAS,EAAE,CAAC,wBAAwB,CAAC;oBACrC,OAAO,EAAE,uBAAuB;oBAChC,aAAa,EAAE,IAAI;oBACnB,WAAW,EAAE,KAAK;oBAClB,aAAa,EAAE,CAAC,UAAU,CAAC;iBAC5B;aACF;YACD,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,mBAAmB;oBACvB,IAAI,EAAE,aAAa;oBACnB,aAAa,EAAE,oBAAoB;oBACnC,SAAS,EAAE,CAAC,oBAAoB,CAAC;oBACjC,aAAa,EAAE,qBAAqB;iBACrC;gBACD;oBACE,EAAE,EAAE,uBAAuB;oBAC3B,IAAI,EAAE,iBAAiB;oBACvB,aAAa,EAAE,wBAAwB;oBACvC,SAAS,EAAE,CAAC,wBAAwB,CAAC;oBACrC,aAAa,EAAE,qBAAqB;iBACrC;aACF;YACD,SAAS,EAAE;gBACT;oBACE,EAAE,EAAE,uBAAuB;oBAC3B,IAAI,EAAE,cAAc;oBACpB,GAAG,EAAE,gDAAgD;iBACtD;gBACD;oBACE,EAAE,EAAE,eAAe;oBACnB,IAAI,EAAE,MAAM;oBACZ,GAAG,EAAE,kDAAkD;iBACxD;aACF;SACF;KACF;CACF,CAAC"}

package/dist/src/sceneRunner.d.ts

@@ -0,0 +1,20 @@
+import { DiscoveryService } from "./discoveryService";
+import { StructuredLogger } from "./logger";
+import type { SceneDefinition, SceneRunResult, SonosTransport } from "./types";
+export declare class SceneRunner {
+    private readonly discoveryService;
+    private readonly transport;
+    private readonly logger;
+    private queues;
+    constructor(discoveryService: DiscoveryService, transport: SonosTransport, logger: StructuredLogger);
+    runOn(scene: SceneDefinition): Promise<SceneRunResult>;
+    runOff(scene: SceneDefinition): Promise<SceneRunResult>;
+    runTest(scene: SceneDefinition): Promise<SceneRunResult>;
+    private enqueue;
+    private execute;
+    private result;
+    private executeOn;
+    private executeOff;
+    private verifyGrouping;
+    private withRetry;
+}

package/dist/src/sceneRunner.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SceneRunner = void 0;
+const config_1 = require("./config");
+const logger_1 = require("./logger");
+function sleep(ms) {
+    if (ms <= 0) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+class SceneRunner {
+    discoveryService;
+    transport;
+    logger;
+    queues = new Map();
+    constructor(discoveryService, transport, logger) {
+        this.discoveryService = discoveryService;
+        this.transport = transport;
+        this.logger = logger;
+    }
+    runOn(scene) {
+        return this.enqueue(scene, "on");
+    }
+    runOff(scene) {
+        return this.enqueue(scene, "off");
+    }
+    runTest(scene) {
+        return this.enqueue(scene, "test");
+    }
+    enqueue(scene, trigger) {
+        const queueKey = `${scene.householdId}:${scene.coordinatorPlayerId || scene.id}`;
+        const previous = this.queues.get(queueKey) ?? Promise.resolve({
+            ok: true,
+            sceneId: scene.id,
+            trigger,
+            logs: [],
+            errors: [],
+        });
+        const next = previous
+            .catch(() => undefined)
+            .then(() => this.execute(scene, trigger))
+            .finally(() => {
+            if (this.queues.get(queueKey) === next) {
+                this.queues.delete(queueKey);
+            }
+        });
+        this.queues.set(queueKey, next);
+        return next;
+    }
+    async execute(scene, trigger) {
+        const collector = new logger_1.MemoryLogCollector();
+        const logger = this.logger.child(scene.id);
+        const scopedLogger = new logger_1.StructuredLogger(`scene:${scene.id}`, "debug", undefined, collector);
+        const errors = [];
+        const log = (level, message) => {
+            scopedLogger[level](message);
+            logger[level](message);
+        };
+        log("info", `Running scene "${scene.name}" (${trigger}).`);
+        try {
+            let snapshot = await this.discoveryService.refresh();
+            const validation = (0, config_1.validateSceneDefinition)(scene, snapshot, this.transport);
+            if (!validation.valid) {
+                throw new Error(validation.errors.join(" "));
+            }
+            if (validation.warnings.length > 0) {
+                for (const warning of validation.warnings) {
+                    log("warn", warning);
+                }
+            }
+            if (trigger === "off") {
+                await this.executeOff(scene, log);
+                snapshot = await this.discoveryService.refresh();
+                log("info", `Scene "${scene.name}" off action complete.`);
+                return this.result(true, scene.id, trigger, collector.entries, errors, snapshot);
+            }
+            await this.executeOn(scene, log);
+            snapshot = await this.discoveryService.refresh();
+            this.verifyGrouping(scene, snapshot, log);
+            log("info", `Scene "${scene.name}" complete.`);
+            return this.result(true, scene.id, trigger, collector.entries, errors, snapshot);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            errors.push(message);
+            log("error", message);
+            return this.result(false, scene.id, trigger, collector.entries, errors);
+        }
+    }
+    result(ok, sceneId, trigger, logs, errors, snapshot) {
+        return {
+            ok,
+            sceneId,
+            trigger,
+            logs,
+            errors,
+            snapshot,
+        };
+    }
+    async executeOn(scene, log) {
+        log("info", `Resolved coordinator: ${scene.coordinatorPlayerId}`);
+        await this.withRetry(scene, "group members", () => this.transport.setGroupMembers(scene.householdId, scene.coordinatorPlayerId, scene.memberPlayerIds));
+        log("info", `Grouped members: ${scene.memberPlayerIds.join(", ") || "none"}`);
+        await sleep(scene.settleMs);
+        if (scene.source?.kind === "favorite") {
+            const source = scene.source;
+            await this.withRetry(scene, `load favorite ${source.favoriteId}`, () => this.transport.loadFavorite(scene.householdId, scene.coordinatorPlayerId, source.favoriteId));
+            log("info", `Selected favorite: ${source.favoriteId}`);
+            await sleep(scene.settleMs);
+        }
+        if (scene.source?.kind === "line_in") {
+            const source = scene.source;
+            await this.withRetry(scene, `load line-in ${scene.source.deviceId}`, () => this.transport.loadLineIn(scene.householdId, scene.coordinatorPlayerId, source.deviceId, source.playOnCompletion));
+            log("info", `Selected source: line_in (${source.deviceId})`);
+            await sleep(scene.settleMs);
+        }
+        if (scene.source?.kind === "tv") {
+            const source = scene.source;
+            if (!this.transport.loadTv) {
+                throw new Error("The active transport does not implement TV source loading.");
+            }
+            await this.withRetry(scene, `load TV ${scene.source.deviceId}`, () => this.transport.loadTv(scene.householdId, scene.coordinatorPlayerId, source.deviceId, source.playOnCompletion));
+            log("info", `Selected source: tv (${source.deviceId})`);
+            await sleep(scene.settleMs);
+        }
+        if (scene.coordinatorVolume !== undefined) {
+            await this.withRetry(scene, `set coordinator volume ${scene.coordinatorVolume}`, () => this.transport.setPlayerVolume(scene.householdId, scene.coordinatorPlayerId, scene.coordinatorVolume));
+            log("info", `Set coordinator volume: ${scene.coordinatorPlayerId}=${scene.coordinatorVolume}`);
+        }
+        for (const volume of scene.playerVolumes) {
+            await this.withRetry(scene, `set room volume ${volume.playerId}=${volume.volume}`, () => this.transport.setPlayerVolume(scene.householdId, volume.playerId, volume.volume));
+            log("info", `Set volume: ${volume.playerId}=${volume.volume}`);
+        }
+    }
+    async executeOff(scene, log) {
+        if (scene.offBehavior.kind === "none") {
+            log("info", "Off behavior is set to none; nothing to do.");
+            return;
+        }
+        if (scene.offBehavior.kind === "ungroup") {
+            await this.withRetry(scene, "ungroup members", () => this.transport.ungroup(scene.householdId, scene.coordinatorPlayerId, scene.memberPlayerIds));
+            log("info", `Ungrouped members: ${scene.memberPlayerIds.join(", ") || "none"}`);
+        }
+    }
+    verifyGrouping(scene, snapshot, log) {
+        const household = snapshot.households.find((item) => item.id === scene.householdId);
+        if (!household) {
+            log("warn", "Verification skipped because the household is no longer present.");
+            return;
+        }
+        const group = household.groups.find((item) => item.coordinatorId === scene.coordinatorPlayerId)
+            ?? household.groups.find((item) => item.playerIds.includes(scene.coordinatorPlayerId));
+        if (!group) {
+            log("warn", "Verification could not find the coordinator group after execution.");
+            return;
+        }
+        const expectedMembers = new Set([scene.coordinatorPlayerId, ...scene.memberPlayerIds]);
+        const actualMembers = new Set(group.playerIds);
+        const missing = Array.from(expectedMembers).filter((playerId) => !actualMembers.has(playerId));
+        if (missing.length > 0) {
+            log("warn", `Post-run verification is missing grouped members: ${missing.join(", ")}`);
+            return;
+        }
+        log("debug", `Post-run verification passed for group ${group.id}.`);
+    }
+    async withRetry(scene, label, action) {
+        let lastError;
+        for (let attempt = 0; attempt <= scene.retryCount; attempt++) {
+            try {
+                await action();
+                return;
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt >= scene.retryCount) {
+                    break;
+                }
+                await sleep(scene.retryDelayMs);
+            }
+        }
+        throw new Error(`${label} failed after ${scene.retryCount + 1} attempt(s): ${lastError instanceof Error ? lastError.message : String(lastError)}`);
+    }
+}
+exports.SceneRunner = SceneRunner;
+//# sourceMappingURL=sceneRunner.js.map

package/dist/src/sceneRunner.js.map

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

package/dist/src/transports/index.d.ts

@@ -0,0 +1,2 @@
+import type { ScenesPlatformConfig, SonosTransport } from "../types";
+export declare function createTransport(configInput: Partial<ScenesPlatformConfig> | undefined): SonosTransport;

package/dist/src/transports/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTransport = createTransport;
+const config_1 = require("../config");
+const localTransport_1 = require("./localTransport");
+function createTransport(configInput) {
+    const config = (0, config_1.normalizePlatformConfig)(configInput);
+    if (config.transport.kind === "local") {
+        return new localTransport_1.LocalSonosTransport(config.transport);
+    }
+    throw new Error(`Unsupported transport kind: ${config.transport.kind ?? "unknown"}`);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/transports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transports/index.ts"],"names":[],"mappings":";;AAIA,0CAQC;AAZD,sCAAoD;AAEpD,qDAAuD;AAEvD,SAAgB,eAAe,CAAC,WAAsD;IACpF,MAAM,MAAM,GAAG,IAAA,gCAAuB,EAAC,WAAW,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACtC,OAAO,IAAI,oCAAmB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,+BAAgC,MAAM,CAAC,SAA+B,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC;AAC9G,CAAC"}

package/dist/src/transports/localTransport.d.ts

@@ -0,0 +1,33 @@
+import type { LocalTransportConfig, SceneSourceKind, SonosTransport, TopologySnapshot } from "../types";
+export declare class LocalSonosTransport implements SonosTransport {
+    private readonly config;
+    readonly kind = "local";
+    private livePlayers;
+    private fixtureState;
+    private fixtureLoaded;
+    private householdRoots;
+    private lastSnapshot;
+    constructor(config: LocalTransportConfig);
+    supportsSource(kind: SceneSourceKind): boolean;
+    discoverHouseholds(): Promise<{
+        id: string;
+        displayName: string;
+    }[]>;
+    discoverTopology(): Promise<TopologySnapshot>;
+    setGroupMembers(householdId: string, coordinatorPlayerId: string, memberPlayerIds: string[]): Promise<void>;
+    modifyGroupMembers(householdId: string, coordinatorPlayerId: string, membersToAdd: string[], membersToRemove: string[]): Promise<void>;
+    loadLineIn(householdId: string, coordinatorPlayerId: string, deviceId: string, playOnCompletion?: boolean): Promise<void>;
+    loadFavorite(householdId: string, coordinatorPlayerId: string, favoriteId: string): Promise<void>;
+    loadTv(householdId: string, coordinatorPlayerId: string, deviceId: string, playOnCompletion?: boolean): Promise<void>;
+    setGroupVolume(householdId: string, coordinatorPlayerId: string, volume: number): Promise<void>;
+    setPlayerVolume(householdId: string, playerId: string, volume: number): Promise<void>;
+    ungroup(householdId: string, coordinatorPlayerId: string, memberPlayerIds?: string[]): Promise<void>;
+    private tryLiveDiscovery;
+    private loadFixtureSnapshot;
+    private requireHousehold;
+    private requirePlayer;
+    private requireLiveRecord;
+    private findFavorite;
+    private setFixtureGroupMembers;
+    private touchFixture;
+}