@felixgeelhaar/govee-api-client 1.0.0-beta.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Felix Geelhaar
+
+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,274 @@
+# Govee API TypeScript Client
+
+[![npm version](https://badge.fury.io/js/%40felixgeelhaar%2Fgovee-api-client.svg)](https://badge.fury.io/js/%40felixgeelhaar%2Fgovee-api-client)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/felixgeelhaar/govee-api-client/workflows/CI/badge.svg)](https://github.com/felixgeelhaar/govee-api-client/actions)
+[![codecov](https://codecov.io/gh/felixgeelhaar/govee-api-client/branch/main/graph/badge.svg)](https://codecov.io/gh/felixgeelhaar/govee-api-client)
+
+An enterprise-grade TypeScript client library for the Govee Developer REST API. Built with Domain-Driven Design (DDD) principles and comprehensive error handling.
+
+## Features
+
+- 🎯 **Type-Safe**: Full TypeScript support with comprehensive type definitions
+- 🏗️ **Domain-Driven Design**: Clean architecture following DDD principles
+- ⚡ **Rate Limiting**: Built-in rate limiting to prevent API throttling
+- 🛡️ **Error Handling**: Comprehensive error hierarchy with specific error types
+- 📝 **Logging**: Configurable logging with Pino integration
+- 🧪 **Well Tested**: >95% test coverage with unit and integration tests
+- 🚀 **Production Ready**: Enterprise-grade reliability and performance
+
+## Installation
+
+```bash
+npm install @felixgeelhaar/govee-api-client
+```
+
+## Quick Start
+
+```typescript
+import {
+  GoveeClient,
+  Brightness,
+  ColorRgb,
+  ColorTemperature,
+} from '@felixgeelhaar/govee-api-client';
+
+// Initialize the client
+const client = new GoveeClient({
+  apiKey: 'your-govee-api-key',
+});
+
+// Get all devices
+const devices = await client.getDevices();
+console.log(`Found ${devices.length} devices`);
+
+// Find a specific device
+const livingRoomLight = await client.findDeviceByName('Living Room');
+
+if (livingRoomLight) {
+  // Turn on the light with warm white and 75% brightness
+  await client.turnOnWithColorTemperature(
+    livingRoomLight.deviceId,
+    livingRoomLight.model,
+    ColorTemperature.warmWhite(),
+    new Brightness(75)
+  );
+}
+```
+
+## Configuration
+
+```typescript
+import pino from 'pino';
+
+const client = new GoveeClient({
+  apiKey: 'your-govee-api-key',
+  timeout: 30000, // Request timeout in milliseconds (default: 30000)
+  rateLimit: 100, // Requests per minute (default: 100)
+  logger: pino({ level: 'info' }), // Optional logger (silent by default)
+});
+```
+
+## API Reference
+
+### Device Management
+
+```typescript
+// Get all devices
+const devices = await client.getDevices();
+
+// Get only controllable devices
+const controllableDevices = await client.getControllableDevices();
+
+// Find device by name (case-insensitive)
+const device = await client.findDeviceByName('bedroom');
+
+// Find devices by model
+const devices = await client.findDevicesByModel('H6159');
+
+// Get device state
+const state = await client.getDeviceState(deviceId, model);
+console.log(`Power: ${state.getPowerState()}`);
+console.log(`Online: ${state.isOnline()}`);
+```
+
+### Device Control
+
+```typescript
+// Basic controls
+await client.turnOn(deviceId, model);
+await client.turnOff(deviceId, model);
+await client.setBrightness(deviceId, model, new Brightness(75));
+
+// Color control
+const red = new ColorRgb(255, 0, 0);
+await client.setColor(deviceId, model, red);
+
+const coolWhite = new ColorTemperature(6500);
+await client.setColorTemperature(deviceId, model, coolWhite);
+
+// Convenience methods
+await client.turnOnWithBrightness(deviceId, model, new Brightness(50));
+await client.turnOnWithColor(deviceId, model, red, new Brightness(75));
+await client.turnOnWithColorTemperature(deviceId, model, coolWhite, new Brightness(100));
+```
+
+### Value Objects
+
+#### ColorRgb
+
+```typescript
+// Create RGB colors
+const red = new ColorRgb(255, 0, 0);
+const blue = ColorRgb.fromHex('#0000FF');
+const green = ColorRgb.fromObject({ r: 0, g: 255, b: 0 });
+
+console.log(red.toHex()); // "#ff0000"
+console.log(blue.toString()); // "rgb(0, 0, 255)"
+```
+
+#### ColorTemperature
+
+```typescript
+// Create color temperatures
+const warm = ColorTemperature.warmWhite(); // 2700K
+const cool = ColorTemperature.coolWhite(); // 6500K
+const daylight = ColorTemperature.daylight(); // 5600K
+const custom = new ColorTemperature(4000);
+
+console.log(warm.isWarm()); // true
+console.log(cool.isCool()); // true
+```
+
+#### Brightness
+
+```typescript
+// Create brightness levels
+const dim = Brightness.dim(); // 25%
+const medium = Brightness.medium(); // 50%
+const bright = Brightness.bright(); // 75%
+const custom = new Brightness(85);
+
+console.log(bright.asPercent()); // 0.75
+console.log(custom.isDim()); // false
+```
+
+## Error Handling
+
+The library provides a comprehensive error hierarchy for different types of failures:
+
+```typescript
+import {
+  GoveeApiError,
+  InvalidApiKeyError,
+  RateLimitError,
+  NetworkError,
+} from '@felixgeelhaar/govee-api-client';
+
+try {
+  await client.getDevices();
+} catch (error) {
+  if (error instanceof InvalidApiKeyError) {
+    console.log('API key is invalid or expired');
+    console.log(error.getRecommendation());
+  } else if (error instanceof RateLimitError) {
+    console.log(`Rate limited. Retry after: ${error.getRetryAfterMs()}ms`);
+  } else if (error instanceof GoveeApiError) {
+    console.log(`API Error: ${error.message}`);
+    if (error.isDeviceOffline()) {
+      console.log('Device is currently offline');
+    }
+  } else if (error instanceof NetworkError) {
+    console.log(`Network error: ${error.errorType}`);
+    if (error.isRetryable()) {
+      console.log('This error can be retried');
+    }
+  }
+}
+```
+
+## Rate Limiting
+
+The client automatically handles rate limiting according to Govee's API limits (100 requests per minute by default). All requests are queued and throttled appropriately.
+
+```typescript
+// Customize rate limiting
+const client = new GoveeClient({
+  apiKey: 'your-api-key',
+  rateLimit: 60, // 60 requests per minute
+});
+```
+
+## Domain-Driven Design
+
+The library follows DDD principles with clear separation of concerns:
+
+- **Entities**: `GoveeDevice`, `DeviceState`, `Command`
+- **Value Objects**: `ColorRgb`, `ColorTemperature`, `Brightness`
+- **Repositories**: `IGoveeDeviceRepository`, `GoveeDeviceRepository`
+- **Services**: `GoveeControlService`
+- **Errors**: Comprehensive error hierarchy
+
+## Advanced Usage
+
+### Custom Repository
+
+```typescript
+import { GoveeControlService } from '@felixgeelhaar/govee-api-client';
+
+// Use your own repository implementation
+const service = new GoveeControlService({
+  repository: new CustomGoveeRepository(),
+  rateLimit: 120,
+});
+```
+
+### Command Pattern
+
+```typescript
+import { CommandFactory } from '@felixgeelhaar/govee-api-client';
+
+// Create commands manually
+const powerOn = CommandFactory.powerOn();
+const setBrightness = CommandFactory.brightness(new Brightness(75));
+
+// Send custom commands
+await client.sendCommand(deviceId, model, powerOn);
+await client.sendCommand(deviceId, model, setBrightness);
+```
+
+## Requirements
+
+- Node.js 18.0.0 or higher
+- Valid Govee Developer API key
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the library
+npm run build
+
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Type checking
+npm run lint
+```
+
+## License
+
+MIT © [Felix Geelhaar]
+
+## Contributing
+
+Contributions are welcome! Please ensure all tests pass and maintain the existing code style.
+
+## API Documentation
+
+For more information about the Govee Developer API, visit: https://govee-public.s3.amazonaws.com/developer-docs/GoveeDeveloperAPIReference.pdf

package/dist/GoveeClient.d.ts

@@ -0,0 +1,35 @@
+import { Logger } from 'pino';
+import { GoveeDevice } from './domain/entities/GoveeDevice';
+import { DeviceState } from './domain/entities/DeviceState';
+import { Command } from './domain/entities/Command';
+import { ColorRgb, ColorTemperature, Brightness } from './domain/value-objects';
+export interface GoveeClientConfig {
+    apiKey: string;
+    timeout?: number;
+    rateLimit?: number;
+    logger?: Logger;
+}
+export declare class GoveeClient {
+    private readonly controlService;
+    private readonly logger;
+    constructor(config: GoveeClientConfig);
+    private validateConfig;
+    getDevices(): Promise<GoveeDevice[]>;
+    getDeviceState(deviceId: string, model: string): Promise<DeviceState>;
+    getControllableDevices(): Promise<GoveeDevice[]>;
+    getRetrievableDevices(): Promise<GoveeDevice[]>;
+    findDeviceByName(deviceName: string): Promise<GoveeDevice | undefined>;
+    findDevicesByModel(model: string): Promise<GoveeDevice[]>;
+    sendCommand(deviceId: string, model: string, command: Command): Promise<void>;
+    turnOn(deviceId: string, model: string): Promise<void>;
+    turnOff(deviceId: string, model: string): Promise<void>;
+    setBrightness(deviceId: string, model: string, brightness: Brightness): Promise<void>;
+    setColor(deviceId: string, model: string, color: ColorRgb): Promise<void>;
+    setColorTemperature(deviceId: string, model: string, colorTemperature: ColorTemperature): Promise<void>;
+    turnOnWithBrightness(deviceId: string, model: string, brightness: Brightness): Promise<void>;
+    turnOnWithColor(deviceId: string, model: string, color: ColorRgb, brightness?: Brightness): Promise<void>;
+    turnOnWithColorTemperature(deviceId: string, model: string, colorTemperature: ColorTemperature, brightness?: Brightness): Promise<void>;
+    isDeviceOnline(deviceId: string, model: string): Promise<boolean>;
+    isDevicePoweredOn(deviceId: string, model: string): Promise<boolean>;
+}
+//# sourceMappingURL=GoveeClient.d.ts.map

package/dist/GoveeClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoveeClient.d.ts","sourceRoot":"","sources":["../src/GoveeClient.ts"],"names":[],"mappings":"AAAA,OAAa,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGpC,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,iBAAiB;IAiCrC,OAAO,CAAC,cAAc;IAmBhB,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIpC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIrE,sBAAsB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIhD,qBAAqB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI/C,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAItE,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKzD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrF,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE,mBAAmB,CACvB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,IAAI,CAAC;IAKV,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC;IAIV,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,QAAQ,EACf,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,IAAI,CAAC;IAIV,0BAA0B,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,IAAI,CAAC;IASV,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG3E"}

package/dist/GoveeClient.js

@@ -0,0 +1,97 @@
+import pino from 'pino';
+import { GoveeDeviceRepository } from './infrastructure/GoveeDeviceRepository';
+import { GoveeControlService } from './services/GoveeControlService';
+export class GoveeClient {
+    constructor(config) {
+        this.validateConfig(config);
+        // Initialize logger (silent by default)
+        this.logger = config.logger ?? pino({ level: 'silent' });
+        // Initialize repository
+        const repositoryConfig = {
+            apiKey: config.apiKey,
+            logger: this.logger,
+        };
+        if (config.timeout !== undefined) {
+            repositoryConfig.timeout = config.timeout;
+        }
+        const repository = new GoveeDeviceRepository(repositoryConfig);
+        // Initialize control service
+        const serviceConfig = {
+            repository,
+            logger: this.logger,
+        };
+        if (config.rateLimit !== undefined) {
+            serviceConfig.rateLimit = config.rateLimit;
+        }
+        this.controlService = new GoveeControlService(serviceConfig);
+        this.logger.info('GoveeClient initialized successfully');
+    }
+    validateConfig(config) {
+        if (!config.apiKey || typeof config.apiKey !== 'string' || config.apiKey.trim().length === 0) {
+            throw new Error('API key is required and must be a non-empty string');
+        }
+        if (config.timeout !== undefined &&
+            (!Number.isInteger(config.timeout) || config.timeout <= 0)) {
+            throw new Error('Timeout must be a positive integer');
+        }
+        if (config.rateLimit !== undefined &&
+            (!Number.isInteger(config.rateLimit) || config.rateLimit <= 0)) {
+            throw new Error('Rate limit must be a positive integer');
+        }
+    }
+    // Device management methods
+    async getDevices() {
+        return this.controlService.getDevices();
+    }
+    async getDeviceState(deviceId, model) {
+        return this.controlService.getDeviceState(deviceId, model);
+    }
+    async getControllableDevices() {
+        return this.controlService.getControllableDevices();
+    }
+    async getRetrievableDevices() {
+        return this.controlService.getRetrievableDevices();
+    }
+    async findDeviceByName(deviceName) {
+        return this.controlService.findDeviceByName(deviceName);
+    }
+    async findDevicesByModel(model) {
+        return this.controlService.findDevicesByModel(model);
+    }
+    // Device control methods
+    async sendCommand(deviceId, model, command) {
+        return this.controlService.sendCommand(deviceId, model, command);
+    }
+    async turnOn(deviceId, model) {
+        return this.controlService.turnOn(deviceId, model);
+    }
+    async turnOff(deviceId, model) {
+        return this.controlService.turnOff(deviceId, model);
+    }
+    async setBrightness(deviceId, model, brightness) {
+        return this.controlService.setBrightness(deviceId, model, brightness);
+    }
+    async setColor(deviceId, model, color) {
+        return this.controlService.setColor(deviceId, model, color);
+    }
+    async setColorTemperature(deviceId, model, colorTemperature) {
+        return this.controlService.setColorTemperature(deviceId, model, colorTemperature);
+    }
+    // Convenience methods
+    async turnOnWithBrightness(deviceId, model, brightness) {
+        return this.controlService.turnOnWithBrightness(deviceId, model, brightness);
+    }
+    async turnOnWithColor(deviceId, model, color, brightness) {
+        return this.controlService.turnOnWithColor(deviceId, model, color, brightness);
+    }
+    async turnOnWithColorTemperature(deviceId, model, colorTemperature, brightness) {
+        return this.controlService.turnOnWithColorTemperature(deviceId, model, colorTemperature, brightness);
+    }
+    async isDeviceOnline(deviceId, model) {
+        return this.controlService.isDeviceOnline(deviceId, model);
+    }
+    async isDevicePoweredOn(deviceId, model) {
+        return this.controlService.isDevicePoweredOn(deviceId, model);
+    }
+}
+//# sourceMappingURL=GoveeClient.js.map

package/dist/GoveeClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoveeClient.js","sourceRoot":"","sources":["../src/GoveeClient.ts"],"names":[],"mappings":"AAAA,OAAO,IAAgB,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAarE,MAAM,OAAO,WAAW;IAItB,YAAY,MAAyB;QACnC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAE5B,wCAAwC;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEzD,wBAAwB;QACxB,MAAM,gBAAgB,GAAQ;YAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;QAEF,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,gBAAgB,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC5C,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;QAE/D,6BAA6B;QAC7B,MAAM,aAAa,GAAQ;YACzB,UAAU;YACV,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;QAEF,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,aAAa,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAC;QAE7D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IAC3D,CAAC;IAEO,cAAc,CAAC,MAAyB;QAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7F,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,IACE,MAAM,CAAC,OAAO,KAAK,SAAS;YAC5B,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,EAC1D,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,IACE,MAAM,CAAC,SAAS,KAAK,SAAS;YAC9B,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC,EAC9D,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,KAAa;QAClD,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,sBAAsB;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,sBAAsB,EAAE,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,OAAO,IAAI,CAAC,cAAc,CAAC,qBAAqB,EAAE,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QACvC,OAAO,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,KAAa;QACpC,OAAO,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,yBAAyB;IACzB,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,KAAa,EAAE,OAAgB;QACjE,OAAO,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,KAAa;QAC1C,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,KAAa;QAC3C,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,KAAa,EAAE,UAAsB;QACzE,OAAO,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,KAAa,EAAE,KAAe;QAC7D,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,QAAgB,EAChB,KAAa,EACb,gBAAkC;QAElC,OAAO,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,QAAQ,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACpF,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,oBAAoB,CACxB,QAAgB,EAChB,KAAa,EACb,UAAsB;QAEtB,OAAO,IAAI,CAAC,cAAc,CAAC,oBAAoB,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,QAAgB,EAChB,KAAa,EACb,KAAe,EACf,UAAuB;QAEvB,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,0BAA0B,CAC9B,QAAgB,EAChB,KAAa,EACb,gBAAkC,EAClC,UAAuB;QAEvB,OAAO,IAAI,CAAC,cAAc,CAAC,0BAA0B,CACnD,QAAQ,EACR,KAAK,EACL,gBAAgB,EAChB,UAAU,CACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,KAAa;QAClD,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,QAAgB,EAAE,KAAa;QACrD,OAAO,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/domain/entities/Command.d.ts

@@ -0,0 +1,78 @@
+import { ColorRgb, ColorTemperature, Brightness } from '../value-objects';
+export declare abstract class Command {
+    abstract readonly name: string;
+    abstract readonly value: unknown;
+    abstract toObject(): {
+        name: string;
+        value: unknown;
+    };
+}
+export declare class PowerOnCommand extends Command {
+    readonly name = "turn";
+    readonly value = "on";
+    toObject(): {
+        name: string;
+        value: string;
+    };
+}
+export declare class PowerOffCommand extends Command {
+    readonly name = "turn";
+    readonly value = "off";
+    toObject(): {
+        name: string;
+        value: string;
+    };
+}
+export declare class BrightnessCommand extends Command {
+    readonly name = "brightness";
+    private readonly _brightness;
+    constructor(brightness: Brightness);
+    get value(): number;
+    get brightness(): Brightness;
+    toObject(): {
+        name: string;
+        value: number;
+    };
+}
+export declare class ColorCommand extends Command {
+    readonly name = "color";
+    private readonly _color;
+    constructor(color: ColorRgb);
+    get value(): {
+        r: number;
+        g: number;
+        b: number;
+    };
+    get color(): ColorRgb;
+    toObject(): {
+        name: string;
+        value: {
+            r: number;
+            g: number;
+            b: number;
+        };
+    };
+}
+export declare class ColorTemperatureCommand extends Command {
+    readonly name = "colorTem";
+    private readonly _colorTemperature;
+    constructor(colorTemperature: ColorTemperature);
+    get value(): number;
+    get colorTemperature(): ColorTemperature;
+    toObject(): {
+        name: string;
+        value: number;
+    };
+}
+export declare class CommandFactory {
+    static powerOn(): PowerOnCommand;
+    static powerOff(): PowerOffCommand;
+    static brightness(brightness: Brightness): BrightnessCommand;
+    static color(color: ColorRgb): ColorCommand;
+    static colorTemperature(colorTemperature: ColorTemperature): ColorTemperatureCommand;
+    static fromObject(obj: {
+        name: string;
+        value: unknown;
+    }): Command;
+}
+//# sourceMappingURL=Command.d.ts.map

package/dist/domain/entities/Command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Command.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/Command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE1E,8BAAsB,OAAO;IAC3B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAEjC,QAAQ,CAAC,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE;CACtD;AAED,qBAAa,cAAe,SAAQ,OAAO;IACzC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,KAAK,QAAQ;IAEtB,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAG5C;AAED,qBAAa,eAAgB,SAAQ,OAAO;IAC1C,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,KAAK,SAAS;IAEvB,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAG5C;AAED,qBAAa,iBAAkB,SAAQ,OAAO;IAC5C,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;gBAE7B,UAAU,EAAE,UAAU;IAKlC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAG5C;AAED,qBAAa,YAAa,SAAQ,OAAO;IACvC,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;gBAEtB,KAAK,EAAE,QAAQ;IAK3B,IAAI,KAAK,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAE/C;IAED,IAAI,KAAK,IAAI,QAAQ,CAEpB;IAED,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;CAGzE;AAED,qBAAa,uBAAwB,SAAQ,OAAO;IAClD,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;gBAEzC,gBAAgB,EAAE,gBAAgB;IAK9C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,gBAAgB,IAAI,gBAAgB,CAEvC;IAED,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAG5C;AAED,qBAAa,cAAc;IACzB,MAAM,CAAC,OAAO,IAAI,cAAc;IAIhC,MAAM,CAAC,QAAQ,IAAI,eAAe;IAIlC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,iBAAiB;IAI5D,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,YAAY;IAI3C,MAAM,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,uBAAuB;IAIpF,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;CAiClE"}

package/dist/domain/entities/Command.js

@@ -0,0 +1,119 @@
+import { ColorRgb, ColorTemperature, Brightness } from '../value-objects';
+export class Command {
+}
+export class PowerOnCommand extends Command {
+    constructor() {
+        super(...arguments);
+        this.name = 'turn';
+        this.value = 'on';
+    }
+    toObject() {
+        return { name: this.name, value: this.value };
+    }
+}
+export class PowerOffCommand extends Command {
+    constructor() {
+        super(...arguments);
+        this.name = 'turn';
+        this.value = 'off';
+    }
+    toObject() {
+        return { name: this.name, value: this.value };
+    }
+}
+export class BrightnessCommand extends Command {
+    constructor(brightness) {
+        super();
+        this.name = 'brightness';
+        this._brightness = brightness;
+    }
+    get value() {
+        return this._brightness.level;
+    }
+    get brightness() {
+        return this._brightness;
+    }
+    toObject() {
+        return { name: this.name, value: this.value };
+    }
+}
+export class ColorCommand extends Command {
+    constructor(color) {
+        super();
+        this.name = 'color';
+        this._color = color;
+    }
+    get value() {
+        return this._color.toObject();
+    }
+    get color() {
+        return this._color;
+    }
+    toObject() {
+        return { name: this.name, value: this.value };
+    }
+}
+export class ColorTemperatureCommand extends Command {
+    constructor(colorTemperature) {
+        super();
+        this.name = 'colorTem';
+        this._colorTemperature = colorTemperature;
+    }
+    get value() {
+        return this._colorTemperature.kelvin;
+    }
+    get colorTemperature() {
+        return this._colorTemperature;
+    }
+    toObject() {
+        return { name: this.name, value: this.value };
+    }
+}
+export class CommandFactory {
+    static powerOn() {
+        return new PowerOnCommand();
+    }
+    static powerOff() {
+        return new PowerOffCommand();
+    }
+    static brightness(brightness) {
+        return new BrightnessCommand(brightness);
+    }
+    static color(color) {
+        return new ColorCommand(color);
+    }
+    static colorTemperature(colorTemperature) {
+        return new ColorTemperatureCommand(colorTemperature);
+    }
+    static fromObject(obj) {
+        switch (obj.name) {
+            case 'turn':
+                if (obj.value === 'on') {
+                    return new PowerOnCommand();
+                }
+                else if (obj.value === 'off') {
+                    return new PowerOffCommand();
+                }
+                throw new Error(`Invalid power command value: ${obj.value}`);
+            case 'brightness':
+                if (typeof obj.value === 'number') {
+                    return new BrightnessCommand(new Brightness(obj.value));
+                }
+                throw new Error(`Invalid brightness command value: ${obj.value}`);
+            case 'color':
+                if (typeof obj.value === 'object' && obj.value !== null) {
+                    const colorValue = obj.value;
+                    return new ColorCommand(ColorRgb.fromObject(colorValue));
+                }
+                throw new Error(`Invalid color command value: ${obj.value}`);
+            case 'colorTem':
+                if (typeof obj.value === 'number') {
+                    return new ColorTemperatureCommand(new ColorTemperature(obj.value));
+                }
+                throw new Error(`Invalid color temperature command value: ${obj.value}`);
+            default:
+                throw new Error(`Unknown command name: ${obj.name}`);
+        }
+    }
+}
+//# sourceMappingURL=Command.js.map

package/dist/domain/entities/Command.js.map

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