@bobfrankston/lxlan 0.1.0 → 0.1.2

package/protocol.ts

@@ -1,209 +0,0 @@
-import { HSBK16 } from '@bobfrankston/colorlib';
-import { LxMessage, LxHeader, HEADER_SIZE, MessageType } from './types.js';
-
-let globalSource = Math.floor(Math.random() * 0xFFFFFFFF);
-let sequenceCounter = 0;
-
-/** Get next sequence number (0-255 wrapping) */
-export function nextSequence(): number {
-    sequenceCounter = (sequenceCounter + 1) & 0xFF;
-    return sequenceCounter;
-}
-
-/** Get global source ID */
-export function getSource(): number {
-    return globalSource;
-}
-
-/** MAC string to 8-byte buffer (6 bytes MAC + 2 padding) */
-function macToBuffer(mac: string): Buffer {
-    const buf = Buffer.alloc(8);
-    if (mac && mac !== '00:00:00:00:00:00') {
-        const bytes = mac.split(':').map(b => parseInt(b, 16));
-        for (let i = 0; i < 6; i++) buf[i] = bytes[i] || 0;
-    }
-    return buf;
-}
-
-/** Buffer to MAC string */
-function bufferToMac(buf: Buffer, offset: number = 0): string {
-    const parts: string[] = [];
-    for (let i = 0; i < 6; i++) {
-        parts.push(buf[offset + i].toString(16).padStart(2, '0'));
-    }
-    return parts.join(':');
-}
-
-/** Encode LIFX message to buffer */
-export function encodeMessage(options: {
-    type: number;
-    target?: string;  /** MAC address, empty for broadcast */
-    payload?: Buffer;
-    tagged?: boolean;
-    ackRequired?: boolean;
-    resRequired?: boolean;
-    sequence?: number;
-}): Buffer {
-    const payload = options.payload ?? Buffer.alloc(0);
-    const size = HEADER_SIZE + payload.length;
-    const buf = Buffer.alloc(size);
-
-    const tagged = options.tagged ?? !options.target;
-    const target = options.target ?? '00:00:00:00:00:00';
-    const sequence = options.sequence ?? nextSequence();
-
-    // Frame (8 bytes)
-    buf.writeUInt16LE(size, 0);  // size
-    const protocol = 1024 | (tagged ? 0x2000 : 0) | 0x1000;  // addressable=1, protocol=1024
-    buf.writeUInt16LE(protocol, 2);
-    buf.writeUInt32LE(globalSource, 4);  // source
-
-    // Frame Address (16 bytes)
-    macToBuffer(target).copy(buf, 8);  // target (8 bytes)
-    // reserved (6 bytes at offset 16)
-    const flags = (options.resRequired ? 0x01 : 0) | (options.ackRequired ? 0x02 : 0);
-    buf[22] = flags;
-    buf[23] = sequence;
-
-    // Protocol Header (12 bytes)
-    // reserved (8 bytes at offset 24)
-    buf.writeUInt16LE(options.type, 32);  // type
-    // reserved (2 bytes at offset 34)
-
-    // Payload
-    if (payload.length > 0) {
-        payload.copy(buf, HEADER_SIZE);
-    }
-
-    return buf;
-}
-
-/** Decode LIFX message from buffer */
-export function decodeMessage(buf: Buffer): LxMessage {
-    if (buf.length < HEADER_SIZE) {
-        throw new Error(`Buffer too small: ${buf.length} < ${HEADER_SIZE}`);
-    }
-
-    const size = buf.readUInt16LE(0);
-    const protocolBits = buf.readUInt16LE(2);
-    const tagged = (protocolBits & 0x2000) !== 0;
-    const addressable = (protocolBits & 0x1000) !== 0;
-    const protocol = protocolBits & 0xFFF;
-
-    const source = buf.readUInt32LE(4);
-    const target = bufferToMac(buf, 8);
-    const flags = buf[22];
-    const sequence = buf[23];
-    const type = buf.readUInt16LE(32);
-
-    const payload = buf.length > HEADER_SIZE ? buf.subarray(HEADER_SIZE) : Buffer.alloc(0);
-
-    return {
-        size,
-        protocol,
-        addressable,
-        tagged,
-        source,
-        target,
-        resRequired: (flags & 0x01) !== 0,
-        ackRequired: (flags & 0x02) !== 0,
-        sequence,
-        type,
-        payload
-    };
-}
-
-/** Encode SetPower payload */
-export function encodeSetPower(on: boolean): Buffer {
-    const buf = Buffer.alloc(2);
-    buf.writeUInt16LE(on ? 0xFFFF : 0, 0);
-    return buf;
-}
-
-/** Encode SetColor payload */
-export function encodeSetColor(hsbk: HSBK16, duration: number = 0): Buffer {
-    const buf = Buffer.alloc(13);
-    buf[0] = 0;  // reserved
-    buf.writeUInt16LE(hsbk.h, 1);
-    buf.writeUInt16LE(hsbk.s, 3);
-    buf.writeUInt16LE(hsbk.b, 5);
-    buf.writeUInt16LE(hsbk.k, 7);
-    buf.writeUInt32LE(duration, 9);
-    return buf;
-}
-
-/** Encode SetLabel payload */
-export function encodeSetLabel(label: string): Buffer {
-    const buf = Buffer.alloc(32);
-    buf.write(label.substring(0, 32), 0, 'utf8');
-    return buf;
-}
-
-/** Encode SetGroup payload */
-export function encodeSetGroup(id: string, label: string): Buffer {
-    const buf = Buffer.alloc(56);
-    // 16-byte group ID
-    const idBytes = Buffer.from(id.replace(/-/g, ''), 'hex');
-    idBytes.copy(buf, 0, 0, Math.min(16, idBytes.length));
-    // 32-byte label
-    buf.write(label.substring(0, 32), 16, 'utf8');
-    // 8-byte updated_at timestamp (ns since epoch)
-    const now = BigInt(Date.now()) * BigInt(1000000);
-    buf.writeBigUInt64LE(now, 48);
-    return buf;
-}
-
-/** Encode SetLocation payload (same format as SetGroup) */
-export function encodeSetLocation(id: string, label: string): Buffer {
-    return encodeSetGroup(id, label);
-}
-
-/** Decode State (107) payload - light state */
-export function decodeState(payload: Buffer): { hsbk: HSBK16; power: number; label: string } {
-    return {
-        hsbk: {
-            h: payload.readUInt16LE(0),
-            s: payload.readUInt16LE(2),
-            b: payload.readUInt16LE(4),
-            k: payload.readUInt16LE(6)
-        },
-        power: payload.readUInt16LE(10),
-        label: payload.toString('utf8', 12, 44).replace(/\0+$/, '')
-    };
-}
-
-/** Decode StatePower (22) payload */
-export function decodeStatePower(payload: Buffer): boolean {
-    return payload.readUInt16LE(0) > 0;
-}
-
-/** Decode StateLabel (25) payload */
-export function decodeStateLabel(payload: Buffer): string {
-    return payload.toString('utf8', 0, 32).replace(/\0+$/, '');
-}
-
-/** Decode StateVersion (33) payload */
-export function decodeStateVersion(payload: Buffer): { vendor: number; product: number; version: number } {
-    return {
-        vendor: payload.readUInt32LE(0),
-        product: payload.readUInt32LE(4),
-        version: payload.readUInt32LE(8)
-    };
-}
-
-/** Decode StateGroup (53) or StateLocation (50) payload */
-export function decodeStateGroup(payload: Buffer): { id: string; label: string; updatedAt: number } {
-    const idBytes = payload.subarray(0, 16);
-    const id = idBytes.toString('hex');
-    const label = payload.toString('utf8', 16, 48).replace(/\0+$/, '');
-    const updatedAt = Number(payload.readBigUInt64LE(48) / BigInt(1000000));
-    return { id, label, updatedAt };
-}
-
-/** Decode StateService (3) payload */
-export function decodeStateService(payload: Buffer): { service: number; port: number } {
-    return {
-        service: payload[0],
-        port: payload.readUInt32LE(1)
-    };
-}

package/tsconfig.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "esnext",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "allowSyntheticDefaultImports": true,
-    "esModuleInterop": true,
-    "strict": true,
-    "forceConsistentCasingInFileNames": true,
-    "skipLibCheck": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "strictNullChecks": false,
-    "noImplicitAny": true,
-    "noImplicitThis": true,
-    "newLine": "lf"
-  },
-  "exclude": ["node_modules", "cruft", ".git", "tests", "prev"]
-}

package/types.ts

@@ -1,129 +0,0 @@
-import { HSBK } from '@bobfrankston/colorlib';
-
-/** LIFX message types */
-export const MessageType = {
-    GetService: 2,
-    StateService: 3,
-    GetPower: 20,
-    SetPower: 21,
-    StatePower: 22,
-    GetLabel: 23,
-    SetLabel: 24,
-    StateLabel: 25,
-    GetVersion: 32,
-    StateVersion: 33,
-    GetLocation: 48,
-    SetLocation: 49,
-    StateLocation: 50,
-    GetGroup: 51,
-    SetGroup: 52,
-    StateGroup: 53,
-    Get: 101,  /** GetColor */
-    SetColor: 102,
-    State: 107,  /** LightState */
-} as const;
-
-export type MessageTypeValue = typeof MessageType[keyof typeof MessageType];
-
-/** LIFX protocol header */
-export interface LxHeader {
-    size: number;
-    protocol: number;
-    addressable: boolean;
-    tagged: boolean;
-    source: number;
-    target: string;  /** MAC address as hex string */
-    resRequired: boolean;
-    ackRequired: boolean;
-    sequence: number;
-    type: number;
-}
-
-/** Full LIFX message */
-export interface LxMessage extends LxHeader {
-    payload: Buffer;
-}
-
-/** Group/Location info */
-export interface GroupInfo {
-    id: string;  /** 16-byte GUID as hex */
-    label: string;
-    updatedAt: number;  /** timestamp */
-}
-
-/** Device state for caching */
-export interface DeviceState {
-    power: boolean;
-    color: HSBK;
-    label: string;
-    group: GroupInfo;
-    location: GroupInfo;
-    vendor: number;
-    product: number;
-}
-
-/** LIFX port */
-export const LIFX_PORT = 56700;
-
-/** Header size */
-export const HEADER_SIZE = 36;
-
-/** Product info - common LIFX products */
-export const Products: Record<number, string> = {
-    1: 'LIFX Original 1000',
-    3: 'LIFX Color 650',
-    10: 'LIFX White 800 (Low Voltage)',
-    11: 'LIFX White 800 (High Voltage)',
-    18: 'LIFX White 900 BR30 (Low Voltage)',
-    20: 'LIFX Color 1000 BR30',
-    22: 'LIFX Color 1000',
-    27: 'LIFX A19',
-    28: 'LIFX BR30',
-    29: 'LIFX A19 Night Vision',
-    30: 'LIFX BR30 Night Vision',
-    31: 'LIFX Z',
-    32: 'LIFX Z 2',
-    36: 'LIFX Downlight',
-    37: 'LIFX Downlight',
-    38: 'LIFX Beam',
-    43: 'LIFX A19',
-    44: 'LIFX BR30',
-    45: 'LIFX A19 Night Vision',
-    46: 'LIFX BR30 Night Vision',
-    49: 'LIFX Mini',
-    50: 'LIFX Mini Day and Dusk',
-    51: 'LIFX Mini White',
-    52: 'LIFX GU10',
-    55: 'LIFX Tile',
-    57: 'LIFX Candle',
-    59: 'LIFX Mini Color',
-    60: 'LIFX Mini Day and Dusk',
-    61: 'LIFX Mini White',
-    62: 'LIFX A19',
-    63: 'LIFX BR30',
-    64: 'LIFX A19 Night Vision',
-    65: 'LIFX BR30 Night Vision',
-    66: 'LIFX Mini Color',
-    68: 'LIFX Candle',
-    81: 'LIFX Candle White to Warm',
-    82: 'LIFX Filament Clear',
-    85: 'LIFX Filament Amber',
-    87: 'LIFX Mini White',
-    88: 'LIFX Mini White',
-    89: 'LIFX Switch',
-    90: 'LIFX Clean',
-    91: 'LIFX Color',
-    92: 'LIFX Color',
-    93: 'LIFX A19 US',
-    94: 'LIFX BR30',
-    96: 'LIFX Candle White to Warm',
-    97: 'LIFX A19',
-    98: 'LIFX BR30',
-    99: 'LIFX Clean',
-    100: 'LIFX Filament Clear',
-    101: 'LIFX Filament Amber',
-    109: 'LIFX A19 Night Vision',
-    110: 'LIFX BR30 Night Vision',
-    111: 'LIFX A19 Night Vision Intl',
-    112: 'LIFX BR30 Night Vision Intl',
-};