sinricpro 2.12.1 → 4.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
+
+Copyright (c) 2024 SinricPro
+
+This is a human-readable summary of (and not a substitute for) the license.
+
+You are free to:
+  - Share — copy and redistribute the material in any medium or format
+  - Adapt — remix, transform, and build upon the material for any purpose, even commercially
+
+Under the following terms:
+  - Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made
+  - ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original
+
+Full license text: https://creativecommons.org/licenses/by-sa/4.0/legalcode

package/README.md

@@ -1,15 +1,132 @@
-# SinricPro (NodeJs-SDK)
-
-[![](https://img.shields.io/npm/v/sinricpro)](https://www.npmjs.com/package/sinricpro)
-[![](https://img.shields.io/npm/dependency-version/sinricpro/dev/eslint)](https://www.npmjs.com/package/sinricpro)
-[![](https://img.shields.io/bundlephobia/min/sinricpro)](https://www.npmjs.com/package/sinricpro)
-[![](https://img.shields.io/github/languages/code-size/sinricpro/nodejs-sdk)](https://www.npmjs.com/package/sinricpro)
-
-### Installation
-
-```
-npm install sinricpro
-```
-
-### Examples
-Check the examples [here](https://github.com/sinricpro/nodejs-sdk/tree/master/examples) 
+# SinricPro SDK for Node.js & TypeScript
+
+[![npm version](https://badge.fury.io/js/sinricpro.svg)](https://www.npmjs.com/package/sinricpro)
+[![License](https://img.shields.io/badge/License-CC%20BY--SA%204.0-blue.svg)](LICENSE)
+
+Official SinricPro SDK for Node.js and TypeScript. Control your IoT devices with Alexa and Google Home.
+
+**🎯 Features:**
+- ✅ Full TypeScript support with strong typing
+- ✅ Modern async/await API
+- ✅ WebSocket with automatic reconnection
+- ✅ HMAC-SHA256 authentication
+- ✅ Event rate limiting
+- ✅ Multiple device types (Switch, Light, Thermostat, etc.)
+- ✅ Comprehensive error handling
+- ✅ Unit tested
+
+---
+
+## 📦 Installation
+
+```bash
+npm install sinricpro
+```
+
+Or with yarn:
+```bash
+yarn add sinricpro
+```
+
+---
+
+## 🚀 Quick Start
+
+### 1. Get Your Credentials
+
+1. Sign up at [sinric.pro](https://sinric.pro)
+2. Create a new device (e.g., "Switch")
+3. Copy your credentials:
+   - `APP_KEY`
+   - `APP_SECRET`
+   - `DEVICE_ID`
+
+### 2. Create a Simple Switch
+
+```typescript
+import SinricPro from 'sinricpro';
+import { SinricProSwitch } from 'sinricpro/devices';
+
+const config = {
+  appKey: 'YOUR-APP-KEY',
+  appSecret: 'YOUR-APP-SECRET',
+};
+
+async function main() {
+  // Create a switch device
+  const mySwitch = SinricProSwitch('YOUR-DEVICE-ID');
+
+  // Handle power state changes from Alexa/Google Home
+  mySwitch.onPowerState(async (deviceId, state) => {
+    console.log(`Device turned ${state ? 'ON' : 'OFF'}`);
+    // Control your hardware here
+    return true; // Return true if successful
+  });
+
+  // Add device to SinricPro
+  SinricPro.add(mySwitch);
+
+  // Connection events
+  SinricPro.onConnected(() => console.log('Connected!'));
+  SinricPro.onDisconnected(() => console.log('Disconnected!'));
+
+  // Initialize SDK
+  await SinricPro.begin(config);
+
+  // Send events when state changes locally
+  setTimeout(async () => {
+    await mySwitch.sendPowerStateEvent(true);
+  }, 5000);
+}
+
+main().catch(console.error);
+```
+
+### 3. Run Your App
+
+```bash
+ts-node app.ts
+```
+
+### 4. Control with Voice
+
+- "Alexa, turn on Switch"
+- "OK Google, turn off Switch"
+
+---
+
+## 🤝 Contributing
+
+Contributions welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new features
+4. Submit a pull request
+
+---
+
+## 📄 License
+
+This project is licensed under CC-BY-SA-4.0.
+
+---
+
+## 🔗 Links
+
+- **Website:** [sinric.pro](https://sinric.pro)
+- **Documentation:** [help.sinric.pro](https://help.sinric.pro)
+- **GitHub:** [github.com/sinricpro](https://github.com/sinricpro)
+- **Support:** [community.sinric.pro](https://community.sinric.pro)
+
+---
+
+## 💬 Support
+
+- **Issues:** [GitHub Issues](https://github.com/sinricpro/nodejs-sdk/issues)
+- **Community:** [SinricPro Community](https://community.sinric.pro)
+- **Email:** support@sinric.pro
+
+---
+
+**Made with ❤️ by the SinricPro team**

package/dist/capabilities/AirQualitySensor.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * AirQualitySensor - Adds air quality monitoring capability
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AirQualitySensor = AirQualitySensor;
+const EventLimiter_1 = require("../core/EventLimiter");
+const types_1 = require("../core/types");
+function AirQualitySensor(Base) {
+    return class extends Base {
+        constructor() {
+            super(...arguments);
+            this.airQualityEventLimiter = new EventLimiter_1.EventLimiter(types_1.EVENT_LIMIT_SENSOR_VALUE);
+        }
+        async sendAirQualityEvent(value, cause = types_1.PERIODIC_POLL) {
+            if (this.airQualityEventLimiter.isLimited()) {
+                return false;
+            }
+            return this.sendEvent('currentAirQuality', value, cause);
+        }
+    };
+}
+//# sourceMappingURL=AirQualitySensor.js.map

package/dist/capabilities/AirQualitySensor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AirQualitySensor.js","sourceRoot":"","sources":["../../src/capabilities/AirQualitySensor.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAoBH,4CAeC;AAhCD,uDAAoD;AACpD,yCAAwE;AAgBxE,SAAgB,gBAAgB,CAAyC,IAAO;IAC9E,OAAO,KAAM,SAAQ,IAAI;QAAlB;;YACG,2BAAsB,GAAG,IAAI,2BAAY,CAAC,gCAAwB,CAAC,CAAC;QAY9E,CAAC;QAVC,KAAK,CAAC,mBAAmB,CACvB,KAAsB,EACtB,QAAgB,qBAAa;YAE7B,IAAI,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,EAAE,CAAC;gBAC5C,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/BrightnessController.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * BrightnessController - Adds brightness control capability
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightnessController = BrightnessController;
+const EventLimiter_1 = require("../core/EventLimiter");
+const types_1 = require("../core/types");
+function BrightnessController(Base) {
+    return class extends Base {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        constructor(...args) {
+            super(...args);
+            this.brightnessCallback = null;
+            this.adjustBrightnessCallback = null;
+            this.brightnessEventLimiter = new EventLimiter_1.EventLimiter(types_1.EVENT_LIMIT_STATE);
+            this.registerRequestHandler(this.handleBrightnessRequest.bind(this));
+        }
+        onBrightness(callback) {
+            this.brightnessCallback = callback;
+        }
+        onAdjustBrightness(callback) {
+            this.adjustBrightnessCallback = callback;
+        }
+        async sendBrightnessEvent(brightness, cause = types_1.PHYSICAL_INTERACTION) {
+            if (this.brightnessEventLimiter.isLimited()) {
+                return false;
+            }
+            return this.sendEvent('setBrightness', {
+                brightness,
+            }, cause);
+        }
+        async handleBrightnessRequest(request) {
+            if (request.action === 'setBrightness' && this.brightnessCallback) {
+                const brightness = request.requestValue.brightness;
+                const result = await this.brightnessCallback(this.getDeviceId(), brightness);
+                // Handle both boolean and object return types
+                let success;
+                if (typeof result === 'boolean') {
+                    success = result;
+                }
+                else {
+                    success = result.success;
+                    if (result.message) {
+                        request.errorMessage = result.message;
+                    }
+                }
+                if (success) {
+                    request.responseValue.brightness = brightness;
+                }
+                return success;
+            }
+            if (request.action === 'adjustBrightness' && this.adjustBrightnessCallback) {
+                const brightnessDelta = request.requestValue.brightnessDelta;
+                const result = await this.adjustBrightnessCallback(this.getDeviceId(), brightnessDelta);
+                // Handle both boolean and object return types
+                let success;
+                if (typeof result === 'boolean') {
+                    success = result;
+                }
+                else {
+                    success = result.success;
+                    if (result.message) {
+                        request.errorMessage = result.message;
+                    }
+                }
+                if (success) {
+                    request.responseValue.brightness = brightnessDelta;
+                }
+                return success;
+            }
+            return false;
+        }
+    };
+}
+//# sourceMappingURL=BrightnessController.js.map

package/dist/capabilities/BrightnessController.js.map

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

package/dist/capabilities/CameraController.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * CameraController - Adds camera control capability
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CameraController = CameraController;
+const EventLimiter_1 = require("../core/EventLimiter");
+const types_1 = require("../core/types");
+function CameraController(Base) {
+    return class extends Base {
+        constructor() {
+            super(...arguments);
+            this.cameraEventLimiter = new EventLimiter_1.EventLimiter(types_1.EVENT_LIMIT_STATE);
+        }
+        async sendCameraStreamEvent(streamUrl, protocol = 'RTSP', cause = types_1.PHYSICAL_INTERACTION) {
+            if (this.cameraEventLimiter.isLimited()) {
+                return false;
+            }
+            return this.sendEvent('setCameraStream', { streamUrl, protocol }, cause);
+        }
+        async sendSnapshotEvent(imageUrl, cause = types_1.PHYSICAL_INTERACTION) {
+            if (this.cameraEventLimiter.isLimited()) {
+                return false;
+            }
+            return this.sendEvent('snapshot', { imageUrl }, cause);
+        }
+    };
+}
+//# sourceMappingURL=CameraController.js.map

package/dist/capabilities/CameraController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CameraController.js","sourceRoot":"","sources":["../../src/capabilities/CameraController.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAcH,4CA2BC;AAtCD,uDAAoD;AACpD,yCAAwE;AAUxE,SAAgB,gBAAgB,CAAyC,IAAO;IAC9E,OAAO,KAAM,SAAQ,IAAI;QAAlB;;YACG,uBAAkB,GAAG,IAAI,2BAAY,CAAC,yBAAiB,CAAC,CAAC;QAwBnE,CAAC;QAtBC,KAAK,CAAC,qBAAqB,CACzB,SAAiB,EACjB,WAAmB,MAAM,EACzB,QAAgB,4BAAoB;YAEpC,IAAI,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,CAAC;gBACxC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;QAED,KAAK,CAAC,iBAAiB,CACrB,QAAgB,EAChB,QAAgB,4BAAoB;YAEpC,IAAI,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,CAAC;gBACxC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/ChannelController.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * ChannelController - Adds TV channel control capability
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChannelController = ChannelController;
+const EventLimiter_1 = require("../core/EventLimiter");
+const types_1 = require("../core/types");
+function ChannelController(Base) {
+    return class extends Base {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        constructor(...args) {
+            super(...args);
+            this.changeChannelCallback = null;
+            this.skipChannelsCallback = null;
+            this.channelEventLimiter = new EventLimiter_1.EventLimiter(types_1.EVENT_LIMIT_STATE);
+            this.registerRequestHandler(this.handleChannelRequest.bind(this));
+        }
+        onChangeChannel(callback) {
+            this.changeChannelCallback = callback;
+        }
+        onSkipChannels(callback) {
+            this.skipChannelsCallback = callback;
+        }
+        async sendChannelEvent(channel, cause = types_1.PHYSICAL_INTERACTION) {
+            if (this.channelEventLimiter.isLimited()) {
+                return false;
+            }
+            return this.sendEvent('changeChannel', { channel }, cause);
+        }
+        async handleChannelRequest(request) {
+            if (request.action === 'changeChannel' && this.changeChannelCallback) {
+                const channel = request.requestValue.channel;
+                const success = await this.changeChannelCallback(this.getDeviceId(), channel);
+                if (success) {
+                    request.responseValue.channel = channel;
+                }
+                return success;
+            }
+            if (request.action === 'skipChannels' && this.skipChannelsCallback) {
+                const channelCount = request.requestValue.channelCount;
+                const success = await this.skipChannelsCallback(this.getDeviceId(), channelCount);
+                if (success) {
+                    request.responseValue.channelCount = channelCount;
+                }
+                return success;
+            }
+            return false;
+        }
+    };
+}
+//# sourceMappingURL=ChannelController.js.map

package/dist/capabilities/ChannelController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelController.js","sourceRoot":"","sources":["../../src/capabilities/ChannelController.ts"],"names":[],"mappings":";AAAA;;GAEG;;AA+BH,8CAyDC;AArFD,uDAAoD;AAEpD,yCAAwE;AA0BxE,SAAgB,iBAAiB,CAAyC,IAAO;IAC/E,OAAO,KAAM,SAAQ,IAAI;QAKvB,8DAA8D;QAC9D,YAAY,GAAG,IAAW;YACxB,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;YANT,0BAAqB,GAAiC,IAAI,CAAC;YAC3D,yBAAoB,GAAgC,IAAI,CAAC;YACzD,wBAAmB,GAAG,IAAI,2BAAY,CAAC,yBAAiB,CAAC,CAAC;YAKhE,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,eAAe,CAAC,QAA+B;YAC7C,IAAI,CAAC,qBAAqB,GAAG,QAAQ,CAAC;QACxC,CAAC;QAED,cAAc,CAAC,QAA8B;YAC3C,IAAI,CAAC,oBAAoB,GAAG,QAAQ,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,gBAAgB,CACpB,OAAoB,EACpB,QAAgB,4BAAoB;YAEpC,IAAI,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,EAAE,CAAC;gBACzC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7D,CAAC;QAEO,KAAK,CAAC,oBAAoB,CAAC,OAAyB;YAC1D,IAAI,OAAO,CAAC,MAAM,KAAK,eAAe,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBACrE,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC;gBAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;gBAE9E,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,CAAC,aAAa,CAAC,OAAO,GAAG,OAAO,CAAC;gBAC1C,CAAC;gBAED,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,KAAK,cAAc,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBACnE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC;gBACvD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC,CAAC;gBAElF,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,CAAC,aAAa,CAAC,YAAY,GAAG,YAAY,CAAC;gBACpD,CAAC;gBAED,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/ColorController.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * ColorController - Adds RGB color control capability
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ColorController = ColorController;
+const EventLimiter_1 = require("../core/EventLimiter");
+const types_1 = require("../core/types");
+function ColorController(Base) {
+    return class extends Base {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        constructor(...args) {
+            super(...args);
+            this.colorCallback = null;
+            this.colorEventLimiter = new EventLimiter_1.EventLimiter(types_1.EVENT_LIMIT_STATE);
+            this.registerRequestHandler(this.handleColorRequest.bind(this));
+        }
+        onColor(callback) {
+            this.colorCallback = callback;
+        }
+        async sendColorEvent(r, g, b, cause = types_1.PHYSICAL_INTERACTION) {
+            if (this.colorEventLimiter.isLimited()) {
+                return false;
+            }
+            return this.sendEvent('setColor', {
+                color: { r, g, b },
+            }, cause);
+        }
+        async handleColorRequest(request) {
+            if (request.action !== 'setColor' || !this.colorCallback) {
+                return false;
+            }
+            const { r, g, b } = request.requestValue.color;
+            const result = await this.colorCallback(this.getDeviceId(), r, g, b);
+            // Handle both boolean and object return types
+            let success;
+            if (typeof result === 'boolean') {
+                success = result;
+            }
+            else {
+                success = result.success;
+                if (result.message) {
+                    request.errorMessage = result.message;
+                }
+            }
+            if (success) {
+                request.responseValue.color = { r, g, b };
+            }
+            return success;
+        }
+    };
+}
+//# sourceMappingURL=ColorController.js.map

package/dist/capabilities/ColorController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorController.js","sourceRoot":"","sources":["../../src/capabilities/ColorController.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAeH,0CA4DC;AAxED,uDAAoD;AAEpD,yCAAwE;AAUxE,SAAgB,eAAe,CAAyC,IAAO;IAC7E,OAAO,KAAM,SAAQ,IAAI;QAIvB,8DAA8D;QAC9D,YAAY,GAAG,IAAW;YACxB,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;YALT,kBAAa,GAAyB,IAAI,CAAC;YAC3C,sBAAiB,GAAG,IAAI,2BAAY,CAAC,yBAAiB,CAAC,CAAC;YAK9D,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,CAAC,QAAuB;YAC7B,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAChC,CAAC;QAED,KAAK,CAAC,cAAc,CAClB,CAAS,EACT,CAAS,EACT,CAAS,EACT,QAAgB,4BAAoB;YAEpC,IAAI,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,EAAE,CAAC;gBACvC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CACnB,UAAU,EACV;gBACE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;aACnB,EACD,KAAK,CACN,CAAC;QACJ,CAAC;QAEO,KAAK,CAAC,kBAAkB,CAAC,OAAyB;YACxD,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACzD,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAErE,8CAA8C;YAC9C,IAAI,OAAgB,CAAC;YACrB,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,GAAG,MAAM,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;gBACzB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC;gBACxC,CAAC;YACH,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,aAAa,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5C,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/ColorTemperatureController.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * ColorTemperatureController - Adds color temperature control capability
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ColorTemperatureController = ColorTemperatureController;
+const EventLimiter_1 = require("../core/EventLimiter");
+const types_1 = require("../core/types");
+function ColorTemperatureController(Base) {
+    return class extends Base {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        constructor(...args) {
+            super(...args);
+            this.colorTemperatureCallback = null;
+            this.colorTemperatureEventLimiter = new EventLimiter_1.EventLimiter(types_1.EVENT_LIMIT_STATE);
+            this.registerRequestHandler(this.handleColorTemperatureRequest.bind(this));
+        }
+        onColorTemperature(callback) {
+            this.colorTemperatureCallback = callback;
+        }
+        async sendColorTemperatureEvent(colorTemperature, cause = types_1.PHYSICAL_INTERACTION) {
+            if (this.colorTemperatureEventLimiter.isLimited()) {
+                return false;
+            }
+            return this.sendEvent('setColorTemperature', {
+                colorTemperature,
+            }, cause);
+        }
+        async handleColorTemperatureRequest(request) {
+            if (request.action !== 'setColorTemperature' || !this.colorTemperatureCallback) {
+                return false;
+            }
+            const colorTemperature = request.requestValue.colorTemperature;
+            const result = await this.colorTemperatureCallback(this.getDeviceId(), colorTemperature);
+            // Handle both boolean and object return types
+            let success;
+            if (typeof result === 'boolean') {
+                success = result;
+            }
+            else {
+                success = result.success;
+                if (result.message) {
+                    request.errorMessage = result.message;
+                }
+            }
+            if (success) {
+                request.responseValue.colorTemperature = colorTemperature;
+            }
+            return success;
+        }
+    };
+}
+//# sourceMappingURL=ColorTemperatureController.js.map

package/dist/capabilities/ColorTemperatureController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorTemperatureController.js","sourceRoot":"","sources":["../../src/capabilities/ColorTemperatureController.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAeH,gEA0DC;AAtED,uDAAoD;AAEpD,yCAAwE;AAUxE,SAAgB,0BAA0B,CAAyC,IAAO;IACxF,OAAO,KAAM,SAAQ,IAAI;QAIvB,8DAA8D;QAC9D,YAAY,GAAG,IAAW;YACxB,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;YALT,6BAAwB,GAAoC,IAAI,CAAC;YACjE,iCAA4B,GAAG,IAAI,2BAAY,CAAC,yBAAiB,CAAC,CAAC;YAKzE,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7E,CAAC;QAED,kBAAkB,CAAC,QAAkC;YACnD,IAAI,CAAC,wBAAwB,GAAG,QAAQ,CAAC;QAC3C,CAAC;QAED,KAAK,CAAC,yBAAyB,CAC7B,gBAAwB,EACxB,QAAgB,4BAAoB;YAEpC,IAAI,IAAI,CAAC,4BAA4B,CAAC,SAAS,EAAE,EAAE,CAAC;gBAClD,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CACnB,qBAAqB,EACrB;gBACE,gBAAgB;aACjB,EACD,KAAK,CACN,CAAC;QACJ,CAAC;QAEO,KAAK,CAAC,6BAA6B,CAAC,OAAyB;YACnE,IAAI,OAAO,CAAC,MAAM,KAAK,qBAAqB,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC;gBAC/E,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC;YAC/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,gBAAgB,CAAC,CAAC;YAEzF,8CAA8C;YAC9C,IAAI,OAAgB,CAAC;YACrB,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,GAAG,MAAM,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;gBACzB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC;gBACxC,CAAC;YACH,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,aAAa,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;YAC5D,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/ContactSensor.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * ContactSensor - Adds contact/door sensor capability
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContactSensor = ContactSensor;
+const EventLimiter_1 = require("../core/EventLimiter");
+const types_1 = require("../core/types");
+function ContactSensor(Base) {
+    return class extends Base {
+        constructor() {
+            super(...arguments);
+            this.contactEventLimiter = new EventLimiter_1.EventLimiter(types_1.EVENT_LIMIT_SENSOR_VALUE);
+        }
+        async sendContactEvent(detected, cause = types_1.PHYSICAL_INTERACTION) {
+            if (this.contactEventLimiter.isLimited()) {
+                return false;
+            }
+            return this.sendEvent('setContactState', { state: detected ? 'closed' : 'open' }, cause);
+        }
+    };
+}
+//# sourceMappingURL=ContactSensor.js.map

package/dist/capabilities/ContactSensor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContactSensor.js","sourceRoot":"","sources":["../../src/capabilities/ContactSensor.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAaH,sCAeC;AAzBD,uDAAoD;AACpD,yCAA+E;AAS/E,SAAgB,aAAa,CAAyC,IAAO;IAC3E,OAAO,KAAM,SAAQ,IAAI;QAAlB;;YACG,wBAAmB,GAAG,IAAI,2BAAY,CAAC,gCAAwB,CAAC,CAAC;QAY3E,CAAC;QAVC,KAAK,CAAC,gBAAgB,CACpB,QAAiB,EACjB,QAAgB,4BAAoB;YAEpC,IAAI,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,EAAE,CAAC;gBACzC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;QAC3F,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/Doorbell.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Doorbell - Adds doorbell press capability
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Doorbell = Doorbell;
+const EventLimiter_1 = require("../core/EventLimiter");
+const types_1 = require("../core/types");
+function Doorbell(Base) {
+    return class extends Base {
+        constructor() {
+            super(...arguments);
+            this.doorbellEventLimiter = new EventLimiter_1.EventLimiter(types_1.EVENT_LIMIT_STATE);
+        }
+        async sendDoorbellEvent(cause = types_1.PHYSICAL_INTERACTION) {
+            if (this.doorbellEventLimiter.isLimited()) {
+                return false;
+            }
+            return this.sendEvent('DoorbellPress', { state: 'pressed' }, cause);
+        }
+    };
+}
+//# sourceMappingURL=Doorbell.js.map

package/dist/capabilities/Doorbell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Doorbell.js","sourceRoot":"","sources":["../../src/capabilities/Doorbell.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAaH,4BAYC;AAtBD,uDAAoD;AACpD,yCAAwE;AASxE,SAAgB,QAAQ,CAAyC,IAAO;IACtE,OAAO,KAAM,SAAQ,IAAI;QAAlB;;YACG,yBAAoB,GAAG,IAAI,2BAAY,CAAC,yBAAiB,CAAC,CAAC;QASrE,CAAC;QAPC,KAAK,CAAC,iBAAiB,CAAC,QAAgB,4BAAoB;YAC1D,IAAI,IAAI,CAAC,oBAAoB,CAAC,SAAS,EAAE,EAAE,CAAC;gBAC1C,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/EqualizerController.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * EqualizerController - Adds equalizer control capability
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EqualizerController = EqualizerController;
+const EventLimiter_1 = require("../core/EventLimiter");
+const types_1 = require("../core/types");
+function EqualizerController(Base) {
+    return class extends Base {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        constructor(...args) {
+            super(...args);
+            this.setBandsCallback = null;
+            this.adjustBandsCallback = null;
+            this.setModeCallback = null;
+            this.equalizerEventLimiter = new EventLimiter_1.EventLimiter(types_1.EVENT_LIMIT_STATE);
+            this.registerRequestHandler(this.handleEqualizerRequest.bind(this));
+        }
+        onSetBands(callback) {
+            this.setBandsCallback = callback;
+        }
+        onAdjustBands(callback) {
+            this.adjustBandsCallback = callback;
+        }
+        onSetMode(callback) {
+            this.setModeCallback = callback;
+        }
+        async sendBandsEvent(bands, cause = types_1.PHYSICAL_INTERACTION) {
+            if (this.equalizerEventLimiter.isLimited()) {
+                return false;
+            }
+            return this.sendEvent('setBands', { bands }, cause);
+        }
+        async sendModeEvent(mode, cause = types_1.PHYSICAL_INTERACTION) {
+            if (this.equalizerEventLimiter.isLimited()) {
+                return false;
+            }
+            return this.sendEvent('setMode', { mode }, cause);
+        }
+        async handleEqualizerRequest(request) {
+            if (request.action === 'setBands' && this.setBandsCallback) {
+                const bands = request.requestValue.bands;
+                const result = await this.setBandsCallback(this.getDeviceId(), bands);
+                // Handle both boolean and object return types
+                let success;
+                if (typeof result === 'boolean') {
+                    success = result;
+                }
+                else {
+                    success = result.success;
+                    if (result.message) {
+                        request.errorMessage = result.message;
+                    }
+                }
+                if (success) {
+                    request.responseValue.bands = bands;
+                }
+                return success;
+            }
+            if (request.action === 'adjustBands' && this.adjustBandsCallback) {
+                const bands = request.requestValue.bands;
+                const result = await this.adjustBandsCallback(this.getDeviceId(), bands);
+                // Handle both boolean and object return types
+                let success;
+                if (typeof result === 'boolean') {
+                    success = result;
+                }
+                else {
+                    success = result.success;
+                    if (result.message) {
+                        request.errorMessage = result.message;
+                    }
+                }
+                if (success) {
+                    request.responseValue.bands = bands;
+                }
+                return success;
+            }
+            if (request.action === 'setMode' && this.setModeCallback) {
+                const mode = request.requestValue.mode;
+                const result = await this.setModeCallback(this.getDeviceId(), mode);
+                // Handle both boolean and object return types
+                let success;
+                if (typeof result === 'boolean') {
+                    success = result;
+                }
+                else {
+                    success = result.success;
+                    if (result.message) {
+                        request.errorMessage = result.message;
+                    }
+                }
+                if (success) {
+                    request.responseValue.mode = mode;
+                }
+                return success;
+            }
+            return false;
+        }
+    };
+}
+//# sourceMappingURL=EqualizerController.js.map

package/dist/capabilities/EqualizerController.js.map

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