@bobfrankston/lxlan 0.1.0

package/device.js

@@ -0,0 +1,149 @@
+import { parseColor, hsbkTo16 } from '@bobfrankston/colorlib';
+import { MessageType, Products, LIFX_PORT } from './types.js';
+import { encodeMessage, encodeSetPower, encodeSetColor, encodeSetLabel, encodeSetGroup, encodeSetLocation } from './protocol.js';
+/**
+ * Represents a LIFX device on the LAN.
+ * State is cached and updated via events from LxClient.
+ */
+export class LxDevice {
+    /** MAC address (lowercase, colon-separated) */
+    mac;
+    /** Current IP address */
+    ip;
+    /** UDP port (default 56700) */
+    port = LIFX_PORT;
+    /** Power state (true = on) */
+    power = false;
+    /** Current color in HSBK format */
+    color = { h: 0, s: 0, b: 0, k: 3500 };
+    /** Device label (user-assigned name) */
+    label = '';
+    /** Whether device is responding */
+    online = false;
+    /** Last message timestamp (Date.now()) */
+    lastSeen = 0;
+    /** Vendor ID (1 = LIFX) */
+    vendor = 0;
+    /** Product ID (see Products table) */
+    product = 0;
+    /** Group membership */
+    group = { id: '', label: '', updatedAt: 0 };
+    /** Location membership */
+    location = { id: '', label: '', updatedAt: 0 };
+    socket;
+    constructor(mac, ip, socket) {
+        this.mac = mac.toLowerCase();
+        this.ip = ip;
+        this.socket = socket;
+    }
+    /** Get product name from product ID */
+    get productName() {
+        return Products[this.product] ?? `Unknown (${this.product})`;
+    }
+    /** Send raw message to device */
+    send(type, payload) {
+        const msg = encodeMessage({
+            type,
+            target: this.mac,
+            payload,
+            ackRequired: false,
+            resRequired: true
+        });
+        this.socket.send(this.ip, this.port, msg);
+    }
+    /** Set power on/off */
+    setPower(on) {
+        const msg = encodeMessage({
+            type: MessageType.SetPower,
+            target: this.mac,
+            payload: encodeSetPower(on),
+            ackRequired: true
+        });
+        this.socket.send(this.ip, this.port, msg);
+    }
+    /**
+     * Set color - accepts flexible input formats
+     * @param color - Color as hex "#ff0000", RGB {r,g,b}, HSL {h,s,l}, HSB {h,s,b}, HSBK {h,s,b,k}, or Kelvin number
+     * @param duration - Transition time in milliseconds (default 0)
+     */
+    setColor(color, duration = 0) {
+        const hsbk = parseColor(color);
+        const hsbk16 = hsbkTo16(hsbk);
+        const msg = encodeMessage({
+            type: MessageType.SetColor,
+            target: this.mac,
+            payload: encodeSetColor(hsbk16, duration),
+            ackRequired: true
+        });
+        this.socket.send(this.ip, this.port, msg);
+    }
+    /**
+     * Set white color temperature
+     * @param kelvin - Color temperature (1500-9000, warm to cool)
+     * @param brightness - Brightness 0-100 (default 100)
+     * @param duration - Transition time in milliseconds (default 0)
+     */
+    setWhite(kelvin, brightness = 100, duration = 0) {
+        this.setColor({ h: 0, s: 0, b: brightness, k: kelvin }, duration);
+    }
+    /** Query full state */
+    getState() {
+        this.send(MessageType.Get);
+    }
+    /** Query power state */
+    getPower() {
+        this.send(MessageType.GetPower);
+    }
+    /** Set label */
+    setLabel(label) {
+        const msg = encodeMessage({
+            type: MessageType.SetLabel,
+            target: this.mac,
+            payload: encodeSetLabel(label),
+            ackRequired: true
+        });
+        this.socket.send(this.ip, this.port, msg);
+    }
+    /** Query label */
+    getLabel() {
+        this.send(MessageType.GetLabel);
+    }
+    /** Set group */
+    setGroup(id, label) {
+        const msg = encodeMessage({
+            type: MessageType.SetGroup,
+            target: this.mac,
+            payload: encodeSetGroup(id, label),
+            ackRequired: true
+        });
+        this.socket.send(this.ip, this.port, msg);
+    }
+    /** Query group */
+    getGroup() {
+        this.send(MessageType.GetGroup);
+    }
+    /** Set location */
+    setLocation(id, label) {
+        const msg = encodeMessage({
+            type: MessageType.SetLocation,
+            target: this.mac,
+            payload: encodeSetLocation(id, label),
+            ackRequired: true
+        });
+        this.socket.send(this.ip, this.port, msg);
+    }
+    /** Query location */
+    getLocation() {
+        this.send(MessageType.GetLocation);
+    }
+    /** Query version */
+    getVersion() {
+        this.send(MessageType.GetVersion);
+    }
+    /** Update last seen timestamp and online status */
+    markSeen() {
+        this.lastSeen = Date.now();
+        this.online = true;
+    }
+}
+//# sourceMappingURL=device.js.map

package/device.js.map

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

package/device.ts

@@ -0,0 +1,170 @@
+import { HSBK, ColorInput, parseColor, hsbkTo16 } from '@bobfrankston/colorlib';
+import { UdpSocket } from '@bobfrankston/lxudp';
+import { GroupInfo, MessageType, Products, LIFX_PORT } from './types.js';
+import { encodeMessage, encodeSetPower, encodeSetColor, encodeSetLabel, encodeSetGroup, encodeSetLocation } from './protocol.js';
+
+/**
+ * Represents a LIFX device on the LAN.
+ * State is cached and updated via events from LxClient.
+ */
+export class LxDevice {
+    /** MAC address (lowercase, colon-separated) */
+    readonly mac: string;
+    /** Current IP address */
+    ip: string;
+    /** UDP port (default 56700) */
+    port: number = LIFX_PORT;
+
+    /** Power state (true = on) */
+    power: boolean = false;
+    /** Current color in HSBK format */
+    color: HSBK = { h: 0, s: 0, b: 0, k: 3500 };
+    /** Device label (user-assigned name) */
+    label: string = '';
+    /** Whether device is responding */
+    online: boolean = false;
+    /** Last message timestamp (Date.now()) */
+    lastSeen: number = 0;
+
+    /** Vendor ID (1 = LIFX) */
+    vendor: number = 0;
+    /** Product ID (see Products table) */
+    product: number = 0;
+
+    /** Group membership */
+    group: GroupInfo = { id: '', label: '', updatedAt: 0 };
+    /** Location membership */
+    location: GroupInfo = { id: '', label: '', updatedAt: 0 };
+
+    private socket: UdpSocket;
+
+    constructor(mac: string, ip: string, socket: UdpSocket) {
+        this.mac = mac.toLowerCase();
+        this.ip = ip;
+        this.socket = socket;
+    }
+
+    /** Get product name from product ID */
+    get productName(): string {
+        return Products[this.product] ?? `Unknown (${this.product})`;
+    }
+
+    /** Send raw message to device */
+    send(type: number, payload?: Buffer): void {
+        const msg = encodeMessage({
+            type,
+            target: this.mac,
+            payload,
+            ackRequired: false,
+            resRequired: true
+        });
+        this.socket.send(this.ip, this.port, msg);
+    }
+
+    /** Set power on/off */
+    setPower(on: boolean): void {
+        const msg = encodeMessage({
+            type: MessageType.SetPower,
+            target: this.mac,
+            payload: encodeSetPower(on),
+            ackRequired: true
+        });
+        this.socket.send(this.ip, this.port, msg);
+    }
+
+    /**
+     * Set color - accepts flexible input formats
+     * @param color - Color as hex "#ff0000", RGB {r,g,b}, HSL {h,s,l}, HSB {h,s,b}, HSBK {h,s,b,k}, or Kelvin number
+     * @param duration - Transition time in milliseconds (default 0)
+     */
+    setColor(color: ColorInput, duration: number = 0): void {
+        const hsbk = parseColor(color);
+        const hsbk16 = hsbkTo16(hsbk);
+        const msg = encodeMessage({
+            type: MessageType.SetColor,
+            target: this.mac,
+            payload: encodeSetColor(hsbk16, duration),
+            ackRequired: true
+        });
+        this.socket.send(this.ip, this.port, msg);
+    }
+
+    /**
+     * Set white color temperature
+     * @param kelvin - Color temperature (1500-9000, warm to cool)
+     * @param brightness - Brightness 0-100 (default 100)
+     * @param duration - Transition time in milliseconds (default 0)
+     */
+    setWhite(kelvin: number, brightness: number = 100, duration: number = 0): void {
+        this.setColor({ h: 0, s: 0, b: brightness, k: kelvin }, duration);
+    }
+
+    /** Query full state */
+    getState(): void {
+        this.send(MessageType.Get);
+    }
+
+    /** Query power state */
+    getPower(): void {
+        this.send(MessageType.GetPower);
+    }
+
+    /** Set label */
+    setLabel(label: string): void {
+        const msg = encodeMessage({
+            type: MessageType.SetLabel,
+            target: this.mac,
+            payload: encodeSetLabel(label),
+            ackRequired: true
+        });
+        this.socket.send(this.ip, this.port, msg);
+    }
+
+    /** Query label */
+    getLabel(): void {
+        this.send(MessageType.GetLabel);
+    }
+
+    /** Set group */
+    setGroup(id: string, label: string): void {
+        const msg = encodeMessage({
+            type: MessageType.SetGroup,
+            target: this.mac,
+            payload: encodeSetGroup(id, label),
+            ackRequired: true
+        });
+        this.socket.send(this.ip, this.port, msg);
+    }
+
+    /** Query group */
+    getGroup(): void {
+        this.send(MessageType.GetGroup);
+    }
+
+    /** Set location */
+    setLocation(id: string, label: string): void {
+        const msg = encodeMessage({
+            type: MessageType.SetLocation,
+            target: this.mac,
+            payload: encodeSetLocation(id, label),
+            ackRequired: true
+        });
+        this.socket.send(this.ip, this.port, msg);
+    }
+
+    /** Query location */
+    getLocation(): void {
+        this.send(MessageType.GetLocation);
+    }
+
+    /** Query version */
+    getVersion(): void {
+        this.send(MessageType.GetVersion);
+    }
+
+    /** Update last seen timestamp and online status */
+    markSeen(): void {
+        this.lastSeen = Date.now();
+        this.online = true;
+    }
+}

package/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export { LxDevice } from './device.js';
+export { LxClient, LxClientOptions } from './client.js';
+export { encodeMessage, decodeMessage } from './protocol.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/index.js

@@ -0,0 +1,5 @@
+export * from './types.js';
+export { LxDevice } from './device.js';
+export { LxClient } from './client.js';
+export { encodeMessage, decodeMessage } from './protocol.js';
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAmB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/index.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export { LxDevice } from './device.js';
+export { LxClient, LxClientOptions } from './client.js';
+export { encodeMessage, decodeMessage } from './protocol.js';