homebridge-lovesac-stealthtech 0.0.0-development

package/dist/protocol/responses.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OUT_OF_RANGE = void 0;
+exports.createDefaultState = createDefaultState;
+exports.parseNotification = parseNotification;
+exports.applyResponse = applyResponse;
+const constants_1 = require("./constants");
+// Sentinel defaults ensure applyResponse always returns changed=true on the
+// first state dump, so every field gets pushed to HomeKit via updateCharacteristic.
+function createDefaultState() {
+    return {
+        power: false,
+        volume: -1,
+        mute: false,
+        source: -1,
+        preset: -1,
+        quietMode: false,
+        bass: -1,
+        treble: -1,
+        centerVolume: -1,
+        rearVolume: -1,
+        balance: -1,
+        subwooferConnected: false,
+    };
+}
+/**
+ * Parse a BLE notification from the UpStream characteristic.
+ * Returns the response code and value, or undefined if not a standard status response.
+ *
+ * Notifications have the format: CC 05/06 AA ... <code> <value>
+ * The last 2 bytes are always code + value for standard status responses.
+ * Version and OTA responses are ignored (handled separately if needed).
+ */
+function parseNotification(data) {
+    if (data.length < 4) {
+        return undefined;
+    }
+    // Version responses (AA 01 03 ...) have trailing bytes that look like valid
+    // status codes — e.g. MCU v1.71 ends with 01 47 which would be Volume=71.
+    // Filter them here as defense-in-depth (also filtered in LovesacDevice).
+    if (data.length >= 5 && data[2] === 0xAA && data[3] === 0x01 && data[4] === 0x03) {
+        return undefined;
+    }
+    const code = data[data.length - 2];
+    const value = data[data.length - 1];
+    // Validate code is in our known range
+    if (code < constants_1.ResponseCode.Volume || code > constants_1.ResponseCode.RearVolume) {
+        return undefined;
+    }
+    return { code, value };
+}
+function inRange(value, min, max) {
+    return value >= min && value <= max;
+}
+/**
+ * Apply a parsed response to the device state. Returns true if state changed.
+ * Out-of-range values are logged and ignored to guard against firmware bugs.
+ */
+function applyResponse(state, response) {
+    const { code, value } = response;
+    switch (code) {
+        case constants_1.ResponseCode.Volume:
+            if (!inRange(value, 0, 36)) {
+                return exports.OUT_OF_RANGE;
+            }
+            if (state.volume === value) {
+                return false;
+            }
+            state.volume = value;
+            return true;
+        case constants_1.ResponseCode.CenterVolume:
+            if (!inRange(value, 0, 30)) {
+                return exports.OUT_OF_RANGE;
+            }
+            if (state.centerVolume === value) {
+                return false;
+            }
+            state.centerVolume = value;
+            return true;
+        case constants_1.ResponseCode.Treble:
+            if (!inRange(value, 0, 20)) {
+                return exports.OUT_OF_RANGE;
+            }
+            if (state.treble === value) {
+                return false;
+            }
+            state.treble = value;
+            return true;
+        case constants_1.ResponseCode.Bass:
+            if (!inRange(value, 0, 20)) {
+                return exports.OUT_OF_RANGE;
+            }
+            if (state.bass === value) {
+                return false;
+            }
+            state.bass = value;
+            return true;
+        case constants_1.ResponseCode.Mute: {
+            if (!inRange(value, 0, 1)) {
+                return exports.OUT_OF_RANGE;
+            }
+            const muted = value === 1;
+            if (state.mute === muted) {
+                return false;
+            }
+            state.mute = muted;
+            return true;
+        }
+        case constants_1.ResponseCode.QuietMode: {
+            if (!inRange(value, 0, 1)) {
+                return exports.OUT_OF_RANGE;
+            }
+            const on = value === 1;
+            if (state.quietMode === on) {
+                return false;
+            }
+            state.quietMode = on;
+            return true;
+        }
+        case constants_1.ResponseCode.Balance:
+            if (!inRange(value, 0, 100)) {
+                return exports.OUT_OF_RANGE;
+            }
+            if (state.balance === value) {
+                return false;
+            }
+            state.balance = value;
+            return true;
+        case constants_1.ResponseCode.Source:
+            if (!inRange(value, 0, 3)) {
+                return exports.OUT_OF_RANGE;
+            }
+            if (state.source === value) {
+                return false;
+            }
+            state.source = value;
+            return true;
+        case constants_1.ResponseCode.Power: {
+            if (!inRange(value, 0, 1)) {
+                return exports.OUT_OF_RANGE;
+            }
+            // INVERTED: 0x00 = ON, 0x01 = OFF
+            const on = value === 0;
+            if (state.power === on) {
+                return false;
+            }
+            state.power = on;
+            return true;
+        }
+        case constants_1.ResponseCode.Preset:
+            if (!inRange(value, 0, 3)) {
+                return exports.OUT_OF_RANGE;
+            }
+            if (state.preset === value) {
+                return false;
+            }
+            state.preset = value;
+            return true;
+        case constants_1.ResponseCode.Subwoofer: {
+            if (!inRange(value, 0, 1)) {
+                return exports.OUT_OF_RANGE;
+            }
+            const connected = value === 1;
+            if (state.subwooferConnected === connected) {
+                return false;
+            }
+            state.subwooferConnected = connected;
+            return true;
+        }
+        case constants_1.ResponseCode.RearVolume:
+            if (!inRange(value, 0, 30)) {
+                return exports.OUT_OF_RANGE;
+            }
+            if (state.rearVolume === value) {
+                return false;
+            }
+            state.rearVolume = value;
+            return true;
+        default:
+            return false;
+    }
+}
+/** Sentinel: applyResponse returns this for out-of-range values so the caller can log a warning. */
+exports.OUT_OF_RANGE = 'out_of_range';

package/dist/scan.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Standalone BLE scanner to find Lovesac StealthTech devices.
+ * Usage: npx homebridge-lovesac-stealthtech scan
+ *    or: node dist/scan.js
+ */
+export {};

package/dist/scan.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Standalone BLE scanner to find Lovesac StealthTech devices.
+ * Usage: npx homebridge-lovesac-stealthtech scan
+ *    or: node dist/scan.js
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const noble_1 = __importDefault(require("@stoprocent/noble"));
+const settings_1 = require("./settings");
+console.log('Scanning for Lovesac StealthTech devices (%ds)...', settings_1.BLE_SCAN_TIMEOUT / 1000);
+console.log('Make sure the soundbar is powered on and no other app is connected.\n');
+const found = [];
+noble_1.default.on('discover', (peripheral) => {
+    const name = peripheral.advertisement?.localName ?? '(unnamed)';
+    const rssi = peripheral.rssi ?? 0;
+    const id = peripheral.address !== '' && peripheral.address !== 'unknown'
+        ? peripheral.address
+        : peripheral.id ?? peripheral.uuid ?? '(unknown)';
+    console.log('  Found: %s [%s] RSSI=%d', name, id, rssi);
+    found.push({ id, name, rssi });
+});
+const startScan = () => {
+    noble_1.default.startScanning([settings_1.SOFA_SERVICE_UUID_SHORT], false, (err) => {
+        if (err) {
+            console.error('Scan error:', err.message);
+            process.exit(1);
+        }
+    });
+};
+if (noble_1.default.state === 'poweredOn') {
+    startScan();
+}
+else {
+    noble_1.default.once('stateChange', (state) => {
+        if (state === 'poweredOn') {
+            startScan();
+        }
+        else {
+            console.error('Bluetooth adapter state:', state);
+            process.exit(1);
+        }
+    });
+}
+setTimeout(() => {
+    noble_1.default.stopScanning();
+    console.log('\nScan complete.');
+    if (found.length === 0) {
+        console.log('No Lovesac devices found.');
+    }
+    else {
+        console.log('\nAdd this to your Homebridge config:');
+        console.log(JSON.stringify({
+            platform: 'LovesacStealthTech',
+            devices: [{ name: found[0].name, address: found[0].id }],
+        }, null, 2));
+    }
+    process.exit(0);
+}, settings_1.BLE_SCAN_TIMEOUT);

package/dist/settings.d.ts

@@ -0,0 +1,38 @@
+import type { PlatformConfig } from 'homebridge';
+export declare const PLUGIN_NAME = "homebridge-lovesac-stealthtech";
+export declare const PLATFORM_NAME = "LovesacStealthTech";
+export declare const SOFA_SERVICE_UUID = "65786365-6c70-6f69-6e74-2e636f6d0000";
+export declare const SOFA_SERVICE_UUID_SHORT = "657863656c706f696e742e636f6d0000";
+export declare const CharUUID: {
+    readonly UpStream: "657863656c706f696e742e636f6d0001";
+    readonly DeviceInfo: "657863656c706f696e742e636f6d0002";
+    readonly EqControl: "657863656c706f696e742e636f6d0003";
+    readonly AudioPath: "657863656c706f696e742e636f6d0004";
+    readonly PlayerControl: "657863656c706f696e742e636f6d0005";
+    readonly SystemLayout: "657863656c706f696e742e636f6d0006";
+    readonly Source: "657863656c706f696e742e636f6d0007";
+    readonly Covering: "657863656c706f696e742e636f6d0008";
+    readonly UserSetting: "657863656c706f696e742e636f6d0009";
+    readonly OTA: "657863656c706f696e742e636f6d000a";
+};
+export declare const MAX_VOLUME = 36;
+export declare const BLE_SCAN_TIMEOUT = 15000;
+export declare function errorMessage(err: unknown): string;
+export interface LovesacDeviceConfig {
+    name: string;
+    address: string;
+    idleTimeout: number;
+    pollInterval: number;
+    volumeControl: 'fan' | 'lightbulb' | 'none';
+    volumeStep: number;
+    presets: {
+        movies: boolean;
+        music: boolean;
+        tv: boolean;
+        news: boolean;
+    };
+}
+export interface LovesacPlatformConfig extends PlatformConfig {
+    devices?: Partial<LovesacDeviceConfig>[];
+}
+export declare function resolveDeviceConfig(raw: Partial<LovesacDeviceConfig>): LovesacDeviceConfig;

package/dist/settings.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BLE_SCAN_TIMEOUT = exports.MAX_VOLUME = exports.CharUUID = exports.SOFA_SERVICE_UUID_SHORT = exports.SOFA_SERVICE_UUID = exports.PLATFORM_NAME = exports.PLUGIN_NAME = void 0;
+exports.errorMessage = errorMessage;
+exports.resolveDeviceConfig = resolveDeviceConfig;
+exports.PLUGIN_NAME = 'homebridge-lovesac-stealthtech';
+exports.PLATFORM_NAME = 'LovesacStealthTech';
+// BLE GATT UUIDs — custom service encodes "excelpoint.com" in ASCII
+exports.SOFA_SERVICE_UUID = '65786365-6c70-6f69-6e74-2e636f6d0000';
+// Noble expects UUIDs without dashes, lowercase
+exports.SOFA_SERVICE_UUID_SHORT = '657863656c706f696e742e636f6d0000';
+exports.CharUUID = {
+    UpStream: '657863656c706f696e742e636f6d0001',
+    DeviceInfo: '657863656c706f696e742e636f6d0002',
+    EqControl: '657863656c706f696e742e636f6d0003',
+    AudioPath: '657863656c706f696e742e636f6d0004',
+    PlayerControl: '657863656c706f696e742e636f6d0005',
+    SystemLayout: '657863656c706f696e742e636f6d0006',
+    Source: '657863656c706f696e742e636f6d0007',
+    Covering: '657863656c706f696e742e636f6d0008',
+    UserSetting: '657863656c706f696e742e636f6d0009',
+    OTA: '657863656c706f696e742e636f6d000a',
+};
+exports.MAX_VOLUME = 36;
+exports.BLE_SCAN_TIMEOUT = 15000;
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function resolveDeviceConfig(raw) {
+    return {
+        name: raw.name ?? 'Lovesac StealthTech',
+        address: raw.address ?? '',
+        idleTimeout: raw.idleTimeout ?? 60,
+        pollInterval: raw.pollInterval ?? 90,
+        volumeControl: raw.volumeControl ?? 'fan',
+        volumeStep: raw.volumeStep ?? 2,
+        presets: {
+            movies: raw.presets?.movies ?? true,
+            music: raw.presets?.music ?? true,
+            tv: raw.presets?.tv ?? true,
+            news: raw.presets?.news ?? true,
+        },
+    };
+}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "homebridge-lovesac-stealthtech",
+  "version": "0.0.0-development",
+  "description": "Homebridge plugin for Lovesac StealthTech Sound + Charge BLE control",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "config.schema.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc -w",
+    "prepublishOnly": "npm run build",
+    "scan": "node dist/scan.js",
+    "semantic-release": "semantic-release"
+  },
+  "keywords": [
+    "homebridge-plugin",
+    "lovesac",
+    "stealthtech",
+    "ble",
+    "bluetooth"
+  ],
+  "author": "Alex Rosenberg <alexr@leftfield.org>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ohmantics/homebridge-lovesac-stealthtech.git"
+  },
+  "homepage": "https://github.com/ohmantics/homebridge-lovesac-stealthtech",
+  "bugs": {
+    "url": "https://github.com/ohmantics/homebridge-lovesac-stealthtech/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/ohmantics"
+  },
+  "engines": {
+    "node": "^20.9.0 || ^22 || ^24",
+    "homebridge": "^1.8.0 || ^2.0.0-beta.0"
+  },
+  "dependencies": {
+    "@stoprocent/noble": "^1.15.0"
+  },
+  "peerDependencies": {
+    "homebridge": "^1.8.0 || ^2.0.0-beta.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "conventional-changelog-conventionalcommits": "^8.0.0",
+    "homebridge": "^1.8.0",
+    "semantic-release": "^24.0.0",
+    "typescript": "^5.3.0"
+  },
+  "release": {
+    "branches": ["main"],
+    "plugins": [
+      [
+        "@semantic-release/commit-analyzer",
+        {
+          "preset": "conventionalcommits",
+          "releaseRules": [
+            {
+              "type": "build",
+              "scope": "deps",
+              "release": "patch"
+            }
+          ]
+        }
+      ],
+      [
+        "@semantic-release/release-notes-generator",
+        {
+          "preset": "conventionalcommits",
+          "presetConfig": {
+            "types": [
+              { "type": "feat", "section": "Features" },
+              { "type": "fix", "section": "Bug Fixes" },
+              { "type": "build", "section": "Dependencies", "hidden": false }
+            ]
+          }
+        }
+      ],
+      "@semantic-release/npm",
+      "@semantic-release/github"
+    ]
+  }
+}