homebridge-lanternic 0.1.0

package/dist/ble/magicLanternBleManager.d.ts

@@ -0,0 +1,78 @@
+import type { Logging } from 'homebridge';
+import type { HciDriver, LanternIcBleConfig, LanternIcDeviceConfig, NobleBinding, WriteMode } from '../types.js';
+import type { NoblePeripheral } from './nobleTypes.js';
+export interface MagicLanternBleOptions {
+    binding: NobleBinding;
+    hciDriver: HciDriver;
+    hciDeviceId: number;
+    hciUserChannel: boolean;
+    hciExtended?: boolean;
+    serviceUuid: string;
+    characteristicUuid: string;
+    keepConnected: boolean;
+    connectTimeoutMs: number;
+    scanTimeoutMs: number;
+    writeTimeoutMs: number;
+    retryAttempts: number;
+    retryDelayMs: number;
+    maxRetryDelayMs: number;
+    reconnectDelayMs: number;
+    maxReconnectDelayMs: number;
+    writeDelayMs: number;
+    idleDisconnectMs: number;
+    writeMode: WriteMode;
+}
+export interface CandidateDevice {
+    id: string;
+    address?: string;
+    connectable?: boolean;
+    manufacturerData?: string;
+    name: string;
+    rssi?: number;
+    serviceUuids: string[];
+}
+export interface MagicLanternDiscoveryOptions {
+    namePrefixes: string[];
+    serviceUuids: string[];
+    minRssi?: number;
+}
+export declare class MagicLanternBleManager {
+    private readonly log;
+    readonly options: MagicLanternBleOptions;
+    private readonly noble;
+    private queue;
+    constructor(log: Logging, config: LanternIcBleConfig | undefined);
+    createClient(device: LanternIcDeviceConfig): MagicLanternBleClient;
+    discoverCandidates(timeoutMs: number, options: MagicLanternDiscoveryOptions): Promise<CandidateDevice[]>;
+    private bindingOptions;
+    runExclusive<T>(operation: () => Promise<T>): Promise<T>;
+    findPeripheral(device: LanternIcDeviceConfig): Promise<NoblePeripheral>;
+    private matchesDevice;
+    private peripheralId;
+}
+export declare class MagicLanternBleClient {
+    private readonly log;
+    private readonly manager;
+    private readonly device;
+    private peripheral?;
+    private characteristic?;
+    private idleTimer?;
+    private reconnectTimer?;
+    private readonly reconnectHandlers;
+    private reconnectDelayMs;
+    private expectedDisconnect;
+    private disconnectListener?;
+    constructor(log: Logging, manager: MagicLanternBleManager, device: LanternIcDeviceConfig);
+    onReconnect(handler: () => Promise<void> | void): () => void;
+    start(): void;
+    writeCommands(commands: Buffer[]): Promise<void>;
+    disconnect(reconnect?: boolean): Promise<void>;
+    private ensureConnected;
+    private write;
+    private shouldWriteWithoutResponse;
+    private scheduleIdleDisconnect;
+    private retryDelay;
+    private scheduleReconnect;
+    private clearReconnectTimer;
+    private emitReconnect;
+}

package/dist/ble/magicLanternBleManager.js

@@ -0,0 +1,325 @@
+import { withBindings } from '@stoprocent/noble';
+import { delay, withTimeout } from '../util/async.js';
+import { formatBluetoothAddress, normalizeBluetoothId, normalizeUuid } from '../util/bluetooth.js';
+import { MAGIC_LANTERN_DEFAULT_CHARACTERISTIC_UUID, MAGIC_LANTERN_DEFAULT_SERVICE_UUID, } from './magicLanternCommands.js';
+export class MagicLanternBleManager {
+    log;
+    options;
+    noble;
+    queue = Promise.resolve();
+    constructor(log, config) {
+        this.log = log;
+        this.options = {
+            binding: config?.binding ?? 'default',
+            hciDriver: config?.hciDriver ?? 'native',
+            hciDeviceId: config?.hciDeviceId ?? 0,
+            hciUserChannel: config?.hciUserChannel ?? false,
+            hciExtended: config?.hciExtended,
+            serviceUuid: normalizeUuid(config?.serviceUuid ?? MAGIC_LANTERN_DEFAULT_SERVICE_UUID),
+            characteristicUuid: normalizeUuid(config?.characteristicUuid ?? MAGIC_LANTERN_DEFAULT_CHARACTERISTIC_UUID),
+            keepConnected: config?.keepConnected ?? false,
+            connectTimeoutMs: config?.connectTimeoutMs ?? 15_000,
+            scanTimeoutMs: config?.scanTimeoutMs ?? 15_000,
+            writeTimeoutMs: config?.writeTimeoutMs ?? 5_000,
+            retryAttempts: config?.retryAttempts ?? 3,
+            retryDelayMs: config?.retryDelayMs ?? 500,
+            maxRetryDelayMs: config?.maxRetryDelayMs ?? 5_000,
+            reconnectDelayMs: config?.reconnectDelayMs ?? 1_000,
+            maxReconnectDelayMs: config?.maxReconnectDelayMs ?? 60_000,
+            writeDelayMs: config?.writeDelayMs ?? 120,
+            idleDisconnectMs: config?.idleDisconnectMs ?? 30_000,
+            writeMode: config?.writeMode ?? 'auto',
+        };
+        this.noble = withBindings(this.options.binding, this.bindingOptions());
+    }
+    createClient(device) {
+        return new MagicLanternBleClient(this.log, this, device);
+    }
+    async discoverCandidates(timeoutMs, options) {
+        return this.runExclusive(async () => {
+            await this.noble.waitForPoweredOnAsync(this.options.connectTimeoutMs);
+            const candidates = new Map();
+            const normalizedPrefixes = options.namePrefixes.map(prefix => prefix.toLowerCase());
+            const normalizedServiceUuids = options.serviceUuids.map(normalizeUuid);
+            await this.noble.startScanningAsync([], true);
+            try {
+                await new Promise(resolve => {
+                    const onDiscover = (peripheral) => {
+                        const name = peripheral.advertisement?.localName ?? '';
+                        const serviceUuids = peripheral.advertisement?.serviceUuids?.map(normalizeUuid) ?? [];
+                        const matchesPrefix = Boolean(name)
+                            && normalizedPrefixes.some(prefix => name.toLowerCase().startsWith(prefix));
+                        const matchesService = normalizedServiceUuids.length > 0
+                            && serviceUuids.some(serviceUuid => normalizedServiceUuids.includes(serviceUuid));
+                        const matchesRssi = typeof options.minRssi !== 'number'
+                            || typeof peripheral.rssi !== 'number'
+                            || peripheral.rssi >= options.minRssi;
+                        if ((!matchesPrefix && !matchesService) || !matchesRssi) {
+                            return;
+                        }
+                        const id = this.peripheralId(peripheral);
+                        candidates.set(normalizeBluetoothId(id), {
+                            id,
+                            address: peripheral.address || undefined,
+                            connectable: peripheral.connectable,
+                            manufacturerData: peripheral.advertisement?.manufacturerData?.toString('hex'),
+                            name,
+                            rssi: peripheral.rssi,
+                            serviceUuids,
+                        });
+                    };
+                    this.noble.on('discover', onDiscover);
+                    setTimeout(() => {
+                        this.noble.removeListener('discover', onDiscover);
+                        resolve();
+                    }, timeoutMs);
+                });
+            }
+            finally {
+                await this.noble.stopScanningAsync();
+            }
+            return [...candidates.values()];
+        });
+    }
+    bindingOptions() {
+        const shouldUseHciOptions = this.options.binding === 'hci'
+            || (this.options.binding === 'default' && process.platform === 'linux');
+        if (!shouldUseHciOptions) {
+            return undefined;
+        }
+        return {
+            deviceId: this.options.hciDeviceId,
+            extended: this.options.hciExtended,
+            hciDriver: this.options.hciDriver,
+            userChannel: this.options.hciUserChannel,
+        };
+    }
+    async runExclusive(operation) {
+        const run = this.queue.then(operation, operation);
+        this.queue = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    async findPeripheral(device) {
+        await this.noble.waitForPoweredOnAsync(this.options.connectTimeoutMs);
+        await this.noble.startScanningAsync([], true);
+        let onDiscover;
+        try {
+            return await withTimeout(new Promise((resolve) => {
+                onDiscover = (peripheral) => {
+                    if (!this.matchesDevice(peripheral, device)) {
+                        return;
+                    }
+                    if (onDiscover) {
+                        this.noble.removeListener('discover', onDiscover);
+                    }
+                    resolve(peripheral);
+                };
+                this.noble.on('discover', onDiscover);
+            }), this.options.scanTimeoutMs, `Timed out scanning for ${device.name} (${formatBluetoothAddress(device.address)})`);
+        }
+        finally {
+            if (onDiscover) {
+                this.noble.removeListener('discover', onDiscover);
+            }
+            await this.noble.stopScanningAsync();
+        }
+    }
+    matchesDevice(peripheral, device) {
+        const configuredId = normalizeBluetoothId(device.address);
+        const discoveredIds = [
+            peripheral.id,
+            peripheral.uuid,
+            peripheral.address,
+        ].filter((value) => Boolean(value)).map(normalizeBluetoothId);
+        return discoveredIds.includes(configuredId);
+    }
+    peripheralId(peripheral) {
+        return peripheral.address || peripheral.uuid || peripheral.id;
+    }
+}
+export class MagicLanternBleClient {
+    log;
+    manager;
+    device;
+    peripheral;
+    characteristic;
+    idleTimer;
+    reconnectTimer;
+    reconnectHandlers = new Set();
+    reconnectDelayMs;
+    expectedDisconnect = false;
+    disconnectListener;
+    constructor(log, manager, device) {
+        this.log = log;
+        this.manager = manager;
+        this.device = device;
+        this.reconnectDelayMs = this.manager.options.reconnectDelayMs;
+    }
+    onReconnect(handler) {
+        this.reconnectHandlers.add(handler);
+        return () => {
+            this.reconnectHandlers.delete(handler);
+        };
+    }
+    start() {
+        if (!this.manager.options.keepConnected) {
+            return;
+        }
+        this.scheduleReconnect(0);
+    }
+    async writeCommands(commands) {
+        this.clearReconnectTimer();
+        await this.manager.runExclusive(async () => {
+            for (let attempt = 1; attempt <= this.manager.options.retryAttempts; attempt += 1) {
+                try {
+                    await this.ensureConnected();
+                    for (const command of commands) {
+                        await this.write(command);
+                        await delay(this.manager.options.writeDelayMs);
+                    }
+                    this.scheduleIdleDisconnect();
+                    this.reconnectDelayMs = this.manager.options.reconnectDelayMs;
+                    return;
+                }
+                catch (error) {
+                    await this.disconnect(false);
+                    if (attempt >= this.manager.options.retryAttempts) {
+                        this.scheduleReconnect();
+                        throw error;
+                    }
+                    const retryDelay = this.retryDelay(attempt);
+                    this.log.debug(`[${this.device.name}] BLE write failed, retrying in ${retryDelay}ms (${attempt}/${this.manager.options.retryAttempts}):`, error instanceof Error ? error.message : String(error));
+                    await delay(retryDelay);
+                }
+            }
+        });
+    }
+    async disconnect(reconnect = false) {
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = undefined;
+        }
+        if (!reconnect) {
+            this.clearReconnectTimer();
+        }
+        const peripheral = this.peripheral;
+        const listener = this.disconnectListener;
+        this.peripheral = undefined;
+        this.characteristic = undefined;
+        this.disconnectListener = undefined;
+        if (peripheral?.state === 'connected') {
+            if (listener) {
+                peripheral.removeListener('disconnect', listener);
+            }
+            this.expectedDisconnect = true;
+            try {
+                await withTimeout(peripheral.disconnectAsync(), this.manager.options.connectTimeoutMs, `Timed out disconnecting from ${this.device.name}`);
+            }
+            finally {
+                this.expectedDisconnect = false;
+            }
+        }
+        else if (listener && peripheral) {
+            peripheral.removeListener('disconnect', listener);
+        }
+    }
+    async ensureConnected() {
+        if (this.peripheral?.state === 'connected' && this.characteristic) {
+            return;
+        }
+        const peripheral = await this.manager.findPeripheral(this.device);
+        this.disconnectListener = () => {
+            this.log.debug(`[${this.device.name}] BLE peripheral disconnected`);
+            this.peripheral = undefined;
+            this.characteristic = undefined;
+            this.disconnectListener = undefined;
+            if (!this.expectedDisconnect) {
+                this.scheduleReconnect();
+            }
+        };
+        peripheral.on('disconnect', this.disconnectListener);
+        await withTimeout(peripheral.connectAsync(), this.manager.options.connectTimeoutMs, `Timed out connecting to ${this.device.name}`);
+        const { characteristics } = await peripheral.discoverSomeServicesAndCharacteristicsAsync([this.manager.options.serviceUuid], [this.manager.options.characteristicUuid]);
+        const characteristic = characteristics[0];
+        if (!characteristic) {
+            await peripheral.disconnectAsync();
+            throw new Error(`Missing Magic Lantern characteristic ${this.manager.options.serviceUuid}/${this.manager.options.characteristicUuid}`);
+        }
+        this.peripheral = peripheral;
+        this.characteristic = characteristic;
+        this.reconnectDelayMs = this.manager.options.reconnectDelayMs;
+        this.log.debug(`[${this.device.name}] BLE connected`);
+    }
+    async write(command) {
+        if (!this.characteristic) {
+            throw new Error(`Cannot write to ${this.device.name}; BLE characteristic is not ready`);
+        }
+        const withoutResponse = this.shouldWriteWithoutResponse(this.characteristic);
+        this.log.debug(`[${this.device.name}] BLE write ${command.toString('hex')} withoutResponse=${withoutResponse}`);
+        await withTimeout(this.characteristic.writeAsync(command, withoutResponse), this.manager.options.writeTimeoutMs, `Timed out writing to ${this.device.name}`);
+    }
+    shouldWriteWithoutResponse(characteristic) {
+        if (this.manager.options.writeMode === 'withResponse') {
+            return false;
+        }
+        if (this.manager.options.writeMode === 'withoutResponse') {
+            return true;
+        }
+        return !characteristic.properties.includes('write') && characteristic.properties.includes('writeWithoutResponse');
+    }
+    scheduleIdleDisconnect() {
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = undefined;
+        }
+        if (this.manager.options.keepConnected || this.manager.options.idleDisconnectMs <= 0) {
+            return;
+        }
+        this.idleTimer = setTimeout(() => {
+            this.disconnect(false).catch(error => {
+                this.log.debug(`[${this.device.name}] Idle disconnect failed:`, error instanceof Error ? error.message : String(error));
+            });
+        }, this.manager.options.idleDisconnectMs);
+    }
+    retryDelay(attempt) {
+        return Math.min(this.manager.options.maxRetryDelayMs, this.manager.options.retryDelayMs * 2 ** (attempt - 1));
+    }
+    scheduleReconnect(delayMs = this.reconnectDelayMs) {
+        if (!this.manager.options.keepConnected || this.reconnectTimer) {
+            return;
+        }
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = undefined;
+            void this.manager.runExclusive(async () => {
+                try {
+                    await this.ensureConnected();
+                    this.log.debug(`[${this.device.name}] BLE reconnect complete`);
+                    this.reconnectDelayMs = this.manager.options.reconnectDelayMs;
+                    this.emitReconnect();
+                }
+                catch (error) {
+                    this.log.debug(`[${this.device.name}] BLE reconnect failed:`, error instanceof Error ? error.message : String(error));
+                    this.reconnectDelayMs = Math.min(this.manager.options.maxReconnectDelayMs, Math.max(this.manager.options.reconnectDelayMs, this.reconnectDelayMs * 2));
+                    this.scheduleReconnect();
+                }
+            });
+        }, delayMs);
+    }
+    clearReconnectTimer() {
+        if (!this.reconnectTimer) {
+            return;
+        }
+        clearTimeout(this.reconnectTimer);
+        this.reconnectTimer = undefined;
+    }
+    emitReconnect() {
+        for (const handler of this.reconnectHandlers) {
+            setTimeout(() => {
+                Promise.resolve(handler()).catch(error => {
+                    this.log.debug(`[${this.device.name}] Reconnect handler failed:`, error instanceof Error ? error.message : String(error));
+                });
+            }, 0);
+        }
+    }
+}
+//# sourceMappingURL=magicLanternBleManager.js.map

package/dist/ble/magicLanternBleManager.js.map

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

package/dist/ble/magicLanternCommands.d.ts

@@ -0,0 +1,16 @@
+import { type RgbColor } from '../color.js';
+import type { BrightnessMode, PowerMode } from '../types.js';
+export declare const MAGIC_LANTERN_DEFAULT_SERVICE_UUID = "fff0";
+export declare const MAGIC_LANTERN_DEFAULT_CHARACTERISTIC_UUID = "fff3";
+export declare const buildPowerCommand: (on: boolean) => Buffer;
+export declare const buildColorCommand: ({ red, green, blue }: RgbColor) => Buffer;
+export declare const buildBrightnessCommand: (brightness: number) => Buffer;
+export declare const shouldUseNativePower: (powerMode?: PowerMode) => boolean;
+export declare const shouldUseRgbBlackOff: (powerMode?: PowerMode) => boolean;
+export declare const shouldUseNativeBrightness: (brightnessMode?: BrightnessMode) => boolean;
+export declare const shouldScaleRgbBrightness: (brightnessMode?: BrightnessMode) => boolean;
+export declare const buildNativeBrightnessCommands: (brightness: number, brightnessMode?: BrightnessMode) => Buffer[];
+export declare const buildPowerOnPrefixCommands: (powerMode?: PowerMode, brightnessMode?: BrightnessMode, brightness?: number) => Buffer[];
+export declare const buildPowerOffCommands: (powerMode?: PowerMode) => Buffer[];
+export declare const buildEffectSpeedCommand: (speed: number) => Buffer;
+export declare const buildBasicEffectCommand: (effectCode: number) => Buffer;

package/dist/ble/magicLanternCommands.js

@@ -0,0 +1,49 @@
+import { clampByte, clampPercent } from '../color.js';
+export const MAGIC_LANTERN_DEFAULT_SERVICE_UUID = 'fff0';
+export const MAGIC_LANTERN_DEFAULT_CHARACTERISTIC_UUID = 'fff3';
+const frame = (...bytes) => Buffer.from(bytes.map(clampByte));
+export const buildPowerCommand = (on) => {
+    return on
+        ? Buffer.from('7e0404f00001ff00ef', 'hex')
+        : Buffer.from('7e0404000000ff00ef', 'hex');
+};
+export const buildColorCommand = ({ red, green, blue }) => {
+    return frame(0x7e, 0x07, 0x05, 0x03, red, green, blue, 0x10, 0xef);
+};
+export const buildBrightnessCommand = (brightness) => {
+    return frame(0x7e, 0x04, 0x01, clampPercent(brightness), 0x01, 0xff, 0xff, 0x00, 0xef);
+};
+export const shouldUseNativePower = (powerMode = 'both') => {
+    return powerMode === 'native' || powerMode === 'both';
+};
+export const shouldUseRgbBlackOff = (powerMode = 'both') => {
+    return powerMode === 'rgbBlack' || powerMode === 'both';
+};
+export const shouldUseNativeBrightness = (brightnessMode = 'rgb') => {
+    return brightnessMode === 'native' || brightnessMode === 'both';
+};
+export const shouldScaleRgbBrightness = (brightnessMode = 'rgb') => {
+    return brightnessMode === 'rgb' || brightnessMode === 'both';
+};
+export const buildNativeBrightnessCommands = (brightness, brightnessMode = 'rgb') => {
+    return shouldUseNativeBrightness(brightnessMode) ? [buildBrightnessCommand(brightness)] : [];
+};
+export const buildPowerOnPrefixCommands = (powerMode = 'both', brightnessMode = 'rgb', brightness = 100) => {
+    return [
+        ...(shouldUseNativePower(powerMode) ? [buildPowerCommand(true)] : []),
+        ...buildNativeBrightnessCommands(brightness, brightnessMode),
+    ];
+};
+export const buildPowerOffCommands = (powerMode = 'both') => {
+    return [
+        ...(shouldUseRgbBlackOff(powerMode) ? [buildColorCommand({ red: 0, green: 0, blue: 0 })] : []),
+        ...(shouldUseNativePower(powerMode) ? [buildPowerCommand(false)] : []),
+    ];
+};
+export const buildEffectSpeedCommand = (speed) => {
+    return frame(0x7e, 0x04, 0x02, clampPercent(speed), 0xff, 0xff, 0xff, 0x00, 0xef);
+};
+export const buildBasicEffectCommand = (effectCode) => {
+    return frame(0x7e, 0x05, 0x03, effectCode, 0x06, 0xff, 0xff, 0x00, 0xef);
+};
+//# sourceMappingURL=magicLanternCommands.js.map

package/dist/ble/magicLanternCommands.js.map

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

package/dist/ble/nobleTypes.d.ts

@@ -0,0 +1,33 @@
+export interface NobleAdvertisement {
+    localName?: string;
+    manufacturerData?: Buffer;
+    serviceUuids?: string[];
+}
+export interface NobleCharacteristic {
+    uuid: string;
+    properties: string[];
+    writeAsync(data: Buffer, withoutResponse: boolean): Promise<void>;
+}
+export interface NoblePeripheral {
+    id: string;
+    uuid?: string;
+    address?: string;
+    advertisement?: NobleAdvertisement;
+    connectable?: boolean;
+    rssi?: number;
+    state?: string;
+    connectAsync(): Promise<void>;
+    disconnectAsync(): Promise<void>;
+    discoverSomeServicesAndCharacteristicsAsync(serviceUuids: string[], characteristicUuids: string[]): Promise<{
+        characteristics: NobleCharacteristic[];
+    }>;
+    on(event: 'disconnect', listener: () => void): void;
+    removeListener(event: 'disconnect', listener: () => void): void;
+}
+export interface NobleAdapter {
+    waitForPoweredOnAsync(timeout?: number): Promise<void>;
+    startScanningAsync(serviceUuids?: string[], allowDuplicates?: boolean): Promise<void>;
+    stopScanningAsync(): Promise<void>;
+    on(event: 'discover', listener: (peripheral: NoblePeripheral) => void): void;
+    removeListener(event: 'discover', listener: (peripheral: NoblePeripheral) => void): void;
+}

package/dist/ble/nobleTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=nobleTypes.js.map

package/dist/ble/nobleTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nobleTypes.js","sourceRoot":"","sources":["../../src/ble/nobleTypes.ts"],"names":[],"mappings":""}

package/dist/color.d.ts

@@ -0,0 +1,10 @@
+import type { ColorOrder } from './types.js';
+export interface RgbColor {
+    red: number;
+    green: number;
+    blue: number;
+}
+export declare const clampByte: (value: number) => number;
+export declare const clampPercent: (value: number) => number;
+export declare const hsbToRgb: (hue: number, saturation: number, brightness: number) => RgbColor;
+export declare const applyColorOrder: (color: RgbColor, colorOrder?: ColorOrder) => RgbColor;

package/dist/color.js

@@ -0,0 +1,65 @@
+export const clampByte = (value) => {
+    if (!Number.isFinite(value)) {
+        return 0;
+    }
+    return Math.max(0, Math.min(255, Math.round(value)));
+};
+export const clampPercent = (value) => {
+    if (!Number.isFinite(value)) {
+        return 0;
+    }
+    return Math.max(0, Math.min(100, Math.round(value)));
+};
+export const hsbToRgb = (hue, saturation, brightness) => {
+    const h = ((hue % 360) + 360) % 360;
+    const s = Math.max(0, Math.min(100, saturation)) / 100;
+    const v = Math.max(0, Math.min(100, brightness)) / 100;
+    const c = v * s;
+    const x = c * (1 - Math.abs(((h / 60) % 2) - 1));
+    const m = v - c;
+    let red = 0;
+    let green = 0;
+    let blue = 0;
+    if (h < 60) {
+        red = c;
+        green = x;
+    }
+    else if (h < 120) {
+        red = x;
+        green = c;
+    }
+    else if (h < 180) {
+        green = c;
+        blue = x;
+    }
+    else if (h < 240) {
+        green = x;
+        blue = c;
+    }
+    else if (h < 300) {
+        red = x;
+        blue = c;
+    }
+    else {
+        red = c;
+        blue = x;
+    }
+    return {
+        red: clampByte((red + m) * 255),
+        green: clampByte((green + m) * 255),
+        blue: clampByte((blue + m) * 255),
+    };
+};
+export const applyColorOrder = (color, colorOrder = 'rgb') => {
+    const values = {
+        r: color.red,
+        g: color.green,
+        b: color.blue,
+    };
+    return {
+        red: values[colorOrder[0]],
+        green: values[colorOrder[1]],
+        blue: values[colorOrder[2]],
+    };
+};
+//# sourceMappingURL=color.js.map

package/dist/color.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { API } from 'homebridge';
+declare const _default: (api: API) => void;
+export default _default;

package/dist/index.js

@@ -0,0 +1,6 @@
+import { LanternIcPlatform } from './platform.js';
+import { PLATFORM_NAME } from './settings.js';
+export default (api) => {
+    api.registerPlatform(PLATFORM_NAME, LanternIcPlatform);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,eAAe,CAAC,GAAQ,EAAE,EAAE;IAC1B,GAAG,CAAC,gBAAgB,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;AACzD,CAAC,CAAC"}