@bobfrankston/lxlan 0.1.0 → 0.1.3

package/client.ts

@@ -1,214 +0,0 @@
-import { EventEmitter } from 'node:events';
-import { hsbk16ToHsbk } from '@bobfrankston/colorlib';
-import { UdpSocket, UdpRetryOptions, getBroadcastAddresses } from '@bobfrankston/lxudp';
-import { LxDevice } from './device.js';
-import { LxMessage, MessageType, LIFX_PORT } from './types.js';
-import { encodeMessage, decodeMessage, decodeState, decodeStatePower, decodeStateLabel, decodeStateVersion, decodeStateGroup, decodeStateService } from './protocol.js';
-
-/**
- * Options for LxClient constructor
- */
-export interface LxClientOptions {
-    /** UDP port to bind (default 56700) */
-    port?: number;
-    /** Broadcast addresses for discovery (auto-detected from network interfaces if not specified) */
-    broadcastAddresses?: string[];
-    /** Auto-discovery interval in ms (0 = manual only, default 0) */
-    discoveryInterval?: number;
-}
-
-/**
- * LIFX LAN client for device discovery and control.
- *
- * Events:
- * - `device` (device: LxDevice) - new device discovered
- * - `message` (device: LxDevice, msg: LxMessage) - any message received
- * - `state` (device: LxDevice) - light state updated
- * - `power` (device: LxDevice) - power state updated
- * - `label` (device: LxDevice) - label updated
- * - `group` (device: LxDevice) - group info updated
- * - `location` (device: LxDevice) - location info updated
- * - `version` (device: LxDevice) - version info received
- * - `error` (err: Error) - transport or protocol error
- */
-export class LxClient extends EventEmitter {
-    private socket: UdpSocket;
-    private port: number;
-    private broadcastAddresses: string[];
-    private discoveryTimer: NodeJS.Timeout;
-
-    /** Cached devices by MAC address (lowercase) */
-    devices: Map<string, LxDevice> = new Map();
-
-    constructor(options: LxClientOptions = {}) {
-        super();
-        this.port = options.port ?? LIFX_PORT;
-        this.broadcastAddresses = options.broadcastAddresses ?? getBroadcastAddresses();
-
-        this.socket = new UdpSocket({
-            port: this.port,
-            reuseAddr: true
-        });
-
-        this.socket.on('message', (data, rinfo) => {
-            this.handleMessage(data, rinfo.address, rinfo.port);
-        });
-
-        this.socket.on('error', (err) => {
-            this.emit('error', err);
-        });
-
-        if (options.discoveryInterval && options.discoveryInterval > 0) {
-            this.discoveryTimer = setInterval(() => this.discover(), options.discoveryInterval);
-        }
-    }
-
-    /** Start listening */
-    async start(): Promise<void> {
-        await this.socket.bind();
-    }
-
-    /** Stop and cleanup */
-    stop(): void {
-        if (this.discoveryTimer) clearInterval(this.discoveryTimer);
-        this.socket.close();
-    }
-
-    /** Set retry options at runtime */
-    setRetryOptions(options: UdpRetryOptions): void {
-        this.socket.setRetryOptions(options);
-    }
-
-    /** Get current retry options */
-    getRetryOptions(): Required<UdpRetryOptions> {
-        return this.socket.getRetryOptions();
-    }
-
-    /** Broadcast discovery to all interfaces */
-    discover(): void {
-        const msg = encodeMessage({
-            type: MessageType.GetService,
-            tagged: true
-        });
-
-        for (const addr of this.broadcastAddresses) {
-            this.socket.send(addr, this.port, msg);
-        }
-    }
-
-    /**
-     * Get device by MAC address
-     * @param mac - MAC address (case-insensitive, with or without colons)
-     * @returns LxDevice or undefined if not found
-     */
-    getDevice(mac: string): LxDevice {
-        return this.devices.get(mac.toLowerCase());
-    }
-
-    /**
-     * Add device manually (bypassing discovery).
-     * Use when you know the device IP from external source.
-     * @param mac - MAC address
-     * @param ip - IP address
-     * @param port - UDP port (default 56700)
-     * @returns LxDevice instance (new or existing)
-     */
-    addDevice(mac: string, ip: string, port: number = LIFX_PORT): LxDevice {
-        const normalizedMac = mac.toLowerCase();
-        let device = this.devices.get(normalizedMac);
-
-        if (!device) {
-            device = new LxDevice(normalizedMac, ip, this.socket);
-            device.port = port;
-            this.devices.set(normalizedMac, device);
-            this.emit('device', device);
-        } else {
-            device.ip = ip;
-            device.port = port;
-        }
-
-        return device;
-    }
-
-    /** Handle incoming message */
-    private handleMessage(data: Buffer, fromIp: string, fromPort: number): void {
-        let msg: LxMessage;
-        try {
-            msg = decodeMessage(data);
-        } catch (e: any) {
-            this.emit('error', new Error(`Decode error: ${e.message}`));
-            return;
-        }
-
-        const mac = msg.target;
-        if (mac === '00:00:00:00:00:00') return;  /** broadcast response without target */
-
-        let device = this.devices.get(mac);
-        const isNew = !device;
-
-        if (!device) {
-            device = new LxDevice(mac, fromIp, this.socket);
-            device.port = fromPort;
-            this.devices.set(mac, device);
-        }
-
-        device.ip = fromIp;
-        device.port = fromPort;
-        device.markSeen();
-
-        if (isNew) {
-            this.emit('device', device);
-        }
-
-        this.emit('message', device, msg);
-
-        switch (msg.type) {
-            case MessageType.StateService: {
-                const info = decodeStateService(msg.payload);
-                device.port = info.port;
-                break;
-            }
-
-            case MessageType.State: {
-                const state = decodeState(msg.payload);
-                device.color = hsbk16ToHsbk(state.hsbk);
-                device.power = state.power > 0;
-                device.label = state.label;
-                this.emit('state', device);
-                break;
-            }
-
-            case MessageType.StatePower: {
-                device.power = decodeStatePower(msg.payload);
-                this.emit('power', device);
-                break;
-            }
-
-            case MessageType.StateLabel: {
-                device.label = decodeStateLabel(msg.payload);
-                this.emit('label', device);
-                break;
-            }
-
-            case MessageType.StateVersion: {
-                const ver = decodeStateVersion(msg.payload);
-                device.vendor = ver.vendor;
-                device.product = ver.product;
-                this.emit('version', device);
-                break;
-            }
-
-            case MessageType.StateGroup: {
-                device.group = decodeStateGroup(msg.payload);
-                this.emit('group', device);
-                break;
-            }
-
-            case MessageType.StateLocation: {
-                device.location = decodeStateGroup(msg.payload);
-                this.emit('location', device);
-                break;
-            }
-        }
-    }
-}

package/device.ts

@@ -1,170 +0,0 @@
-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.ts

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