amaran-light-cli 1.10.0 → 1.12.0

package/dist/ble/colors.js

@@ -0,0 +1,44 @@
+const COLORS = {
+    red: 'ff0000',
+    green: '008000',
+    lime: '00ff00',
+    blue: '0000ff',
+    white: 'ffffff',
+    yellow: 'ffff00',
+    cyan: '00ffff',
+    aqua: '00ffff',
+    magenta: 'ff00ff',
+    fuchsia: 'ff00ff',
+    orange: 'ffa500',
+    purple: '800080',
+    pink: 'ffc0cb',
+    violet: 'ee82ee',
+    teal: '008080',
+};
+export function colorToHSI(value) {
+    if (typeof value !== 'string')
+        throw new Error('Color must be a name or #RRGGBB');
+    let hex = COLORS[value.toLowerCase()] ?? value.replace(/^#/, '');
+    if (/^[0-9a-f]{3}$/i.test(hex))
+        hex = [...hex].map((c) => c + c).join('');
+    if (!/^[0-9a-f]{6}$/i.test(hex))
+        throw new Error(`Unsupported color: ${value}`);
+    const [r, g, b] = [0, 2, 4].map((offset) => parseInt(hex.slice(offset, offset + 2), 16) / 255);
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    if (max === 0)
+        throw new Error('Black has no hue; use intensity 0 or off instead');
+    const delta = max - min;
+    let hue = 0;
+    if (delta !== 0) {
+        if (max === r)
+            hue = ((g - b) / delta) % 6;
+        else if (max === g)
+            hue = (b - r) / delta + 2;
+        else
+            hue = (r - g) / delta + 4;
+        hue *= 60;
+    }
+    return { hue: Math.round((hue + 360) % 360) % 360, saturation: Math.round((delta / max) * 100) };
+}
+//# sourceMappingURL=colors.js.map

package/dist/ble/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/ble/colors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAA2B;IACrC,GAAG,EAAE,QAAQ;IACb,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,QAAQ;CACf,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAClF,IAAI,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjE,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1E,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAC;IAChF,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;IAC/F,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,CAAC;IACxB,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,IAAI,GAAG,KAAK,CAAC;YAAE,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;aACtC,IAAI,GAAG,KAAK,CAAC;YAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;;YACzC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QAC/B,GAAG,IAAI,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;AACnG,CAAC"}

package/dist/ble/configuration.d.ts

@@ -0,0 +1,22 @@
+export interface MeshModel {
+    element: number;
+    model: number;
+    company?: number;
+}
+export interface Composition {
+    company: number;
+    product: number;
+    version: number;
+    features: number;
+    models: MeshModel[];
+}
+export interface ConfigurationLink {
+    configuration(address: number, request: Buffer, accept: (data: Buffer) => boolean): Promise<Buffer>;
+}
+export declare function readConfiguration(link: ConfigurationLink, address: number, request: Buffer, accept: (data: Buffer) => boolean): Promise<Buffer>;
+export declare function composition(data: Buffer, primary: number): Composition;
+export declare function readComposition(link: ConfigurationLink, address: number): Promise<Composition>;
+export declare function modelBindings(link: ConfigurationLink, address: number, model: MeshModel): Promise<number[]>;
+export declare function subscriptions(link: ConfigurationLink, address: number, model: MeshModel): Promise<number[]>;
+export declare function changeSubscription(link: ConfigurationLink, address: number, model: MeshModel, group: number, remove: boolean): Promise<void>;
+//# sourceMappingURL=configuration.d.ts.map

package/dist/ble/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/ble/configuration.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AACD,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrG;AACD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAChC,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAuBtE;AAQD,wBAAsB,eAAe,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAKpG;AACD,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBjH;AACD,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBjH;AACD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/ble/configuration.js

@@ -0,0 +1,122 @@
+export async function readConfiguration(link, address, request, accept) {
+    for (let attempt = 0;; attempt++) {
+        try {
+            return await link.configuration(address, request, accept);
+        }
+        catch (error) {
+            if (attempt === 1)
+                throw error;
+            console.error(`Configuration read ${request.subarray(0, 2).toString('hex')} from ${address} failed; retrying: ${error.message}`);
+            await delay(200);
+        }
+    }
+}
+export function composition(data, primary) {
+    if (data.length < 12 || data[0] !== 2 || data[1] !== 0)
+        throw new Error('Invalid composition status');
+    const models = [];
+    let offset = 12, element = primary;
+    while (offset < data.length) {
+        if (offset + 4 > data.length)
+            throw new Error('Truncated composition element');
+        const sig = data[offset + 2], vendor = data[offset + 3];
+        offset += 4;
+        if (offset + sig * 2 + vendor * 4 > data.length)
+            throw new Error('Truncated composition model list');
+        for (let i = 0; i < sig; i++, offset += 2)
+            models.push({ element, model: data.readUInt16LE(offset) });
+        for (let i = 0; i < vendor; i++, offset += 4)
+            models.push({ element, company: data.readUInt16LE(offset), model: data.readUInt16LE(offset + 2) });
+        element++;
+    }
+    return {
+        company: data.readUInt16LE(2),
+        product: data.readUInt16LE(4),
+        version: data.readUInt16LE(6),
+        features: data.readUInt16LE(10),
+        models,
+    };
+}
+function modelBytes(model) {
+    const data = Buffer.alloc(model.company === undefined ? 2 : 4);
+    if (model.company !== undefined)
+        data.writeUInt16LE(model.company);
+    data.writeUInt16LE(model.model, data.length - 2);
+    return data;
+}
+export async function readComposition(link, address) {
+    return composition(await readConfiguration(link, address, Buffer.from([0x80, 0x08, 0]), (data) => data[0] === 2 && data[1] === 0), address);
+}
+export async function modelBindings(link, address, model) {
+    const header = Buffer.alloc(4);
+    header[0] = 0x80;
+    header[1] = model.company === undefined ? 0x4b : 0x4d;
+    header.writeUInt16LE(model.element, 2);
+    const id = modelBytes(model);
+    const response = await readConfiguration(link, address, Buffer.concat([header, id]), (data) => data.length >= 5 + id.length &&
+        data[0] === 0x80 &&
+        data[1] === header[1] + 1 &&
+        data.readUInt16LE(3) === model.element &&
+        data.subarray(5, 5 + id.length).equals(id));
+    if (response[2] !== 0)
+        throw new Error(`App binding read failed with mesh status ${response[2]}`);
+    const indexes = [];
+    for (let offset = 5 + id.length; offset < response.length; offset += 3) {
+        if (offset + 2 > response.length)
+            throw new Error('Truncated app index list');
+        indexes.push(response.readUInt16LE(offset) & 0xfff);
+        if (offset + 3 <= response.length)
+            indexes.push(response.readUInt16LE(offset + 1) >> 4);
+    }
+    return indexes;
+}
+export async function subscriptions(link, address, model) {
+    const header = Buffer.alloc(4);
+    header[0] = 0x80;
+    header[1] = model.company === undefined ? 0x29 : 0x2b;
+    header.writeUInt16LE(model.element, 2);
+    const id = modelBytes(model);
+    const response = await readConfiguration(link, address, Buffer.concat([header, id]), (data) => data.length >= 5 + id.length &&
+        data[0] === 0x80 &&
+        data[1] === header[1] + 1 &&
+        data.readUInt16LE(3) === model.element &&
+        data.subarray(5, 5 + id.length).equals(id));
+    if (response[2] !== 0)
+        throw new Error(`Subscription read failed with mesh status ${response[2]}`);
+    const start = 5 + id.length;
+    if ((response.length - start) % 2)
+        throw new Error('Truncated subscription addresses');
+    return Array.from({ length: (response.length - start) / 2 }, (_, i) => response.readUInt16LE(start + i * 2));
+}
+export async function changeSubscription(link, address, model, group, remove) {
+    if (!Number.isInteger(group) || group < 0xc000 || group > 0xfeff)
+        throw new Error('Group address must be 0xc000-0xfeff');
+    const header = Buffer.alloc(6);
+    header[0] = 0x80;
+    header[1] = remove ? 0x1c : 0x1b;
+    header.writeUInt16LE(model.element, 2);
+    header.writeUInt16LE(group, 4);
+    const id = modelBytes(model);
+    let response;
+    try {
+        response = await link.configuration(address, Buffer.concat([header, id]), (data) => data.length === 7 + id.length &&
+            data[0] === 0x80 &&
+            data[1] === 0x1f &&
+            data.readUInt16LE(3) === model.element &&
+            data.readUInt16LE(5) === group &&
+            data.subarray(7).equals(id));
+    }
+    catch (error) {
+        const actual = await subscriptions(link, address, model);
+        if (actual.includes(group) !== remove)
+            return;
+        throw new Error(`Subscription write did not verify: ${error.message}`, { cause: error });
+    }
+    if (response[2] !== 0)
+        throw new Error(`Subscription change failed with mesh status ${response[2]}`);
+    const actual = await subscriptions(link, address, model);
+    if (actual.includes(group) === remove)
+        throw new Error('Subscription change did not verify');
+}
+import { setTimeout as delay } from 'node:timers/promises';
+//# sourceMappingURL=configuration.js.map

package/dist/ble/configuration.js.map

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

package/dist/ble/controller.d.ts

@@ -0,0 +1,118 @@
+import type { LocalLibrary, SteadyHistory } from './library.js';
+import type { UnprovisionedDevice } from './provisioning.js';
+import type { ProductInfo } from './settings.js';
+import type { MeshConfig, MeshLight } from './storage.js';
+import { type FanState, type FixtureState } from './telink.js';
+export interface MeshLink {
+    readonly ready: boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(address: number, payload: Buffer): Promise<void>;
+    readState(address: number): Promise<FixtureState>;
+    readFan?(address: number): Promise<FanState>;
+    readProductInfo?(address: number): Promise<ProductInfo>;
+    configuration?(address: number, request: Buffer, accept: (data: Buffer) => boolean): Promise<Buffer>;
+    discoverUnprovisioned?(): Promise<UnprovisionedDevice[]>;
+}
+export declare function capabilities(light: MeshLight): {
+    cct_support: boolean;
+    cct_min: number;
+    cct_max: number;
+    cct_step: number;
+    hsi_support: boolean;
+    rgb_support: boolean;
+    advanced_hsi_support: boolean;
+    gm_support: boolean;
+    gm_min: number;
+    gm_max: number;
+    gm_step: number;
+    fan_support: boolean;
+    fan_policy: string;
+    intensity_step: number;
+    effects: ("paparazzi" | "lightning" | "tv" | "fire" | "strobe" | "explosion" | "faulty-bulb" | "pulsing" | "cop-car" | "party-lights" | "fireworks")[];
+};
+export declare function validateAction(light: MeshLight, action: string, body: Record<string, unknown>): void;
+export interface BatchResult {
+    delivery: 'mesh-broadcast' | 'native-group' | 'batched-unicast';
+    states: Record<string, FixtureState>;
+    triggerRequest?: {
+        sent: true;
+        eventConfirmed: false;
+    };
+}
+export interface CommandState extends FixtureState {
+    triggerRequest?: {
+        sent: true;
+        eventConfirmed: false;
+    };
+}
+export declare class VerifiedController {
+    readonly config: MeshConfig;
+    readonly link: MeshLink;
+    private readonly history?;
+    private queue;
+    private queued;
+    private stopping;
+    private readonly steadyStates;
+    private readonly manualOverrides;
+    constructor(config: MeshConfig, link: MeshLink, history?: SteadyHistory | undefined);
+    importDeviceKeys(database: string, persist: (config: MeshConfig) => void): Promise<number>;
+    nativeGroup(library: LocalLibrary, key: string | undefined, action: 'inspect' | 'enable' | 'sync' | 'disable' | 'add' | 'remove', value?: number | string): Promise<{
+        name: string;
+        id: string;
+        members: string[];
+        native?: {
+            status: "pending" | "ready";
+            address: number;
+            managed: string[];
+        } | undefined;
+    } | {
+        key: string;
+        address: number;
+        composition: import("./configuration.js").Composition;
+        model: import("./configuration.js").MeshModel;
+        groups: number[];
+        keyRefreshPhase: number;
+    }[]>;
+    discoverUnprovisioned(): Promise<UnprovisionedDevice[]>;
+    private light;
+    private hold;
+    overrideStatus(keys: string[]): Record<string, number>;
+    override(keys: string[], minutes: number, signal?: AbortSignal): Promise<Record<string, number>>;
+    reserveControl(keys: string[], minutes: number, signal?: AbortSignal): Promise<void>;
+    automaticCct(key: string, body: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        skipped: true;
+        reason: string;
+        state?: undefined;
+    } | {
+        skipped: false;
+        state: FixtureState;
+        reason?: undefined;
+    }>;
+    productInfo(key: string): Promise<ProductInfo>;
+    private serialize;
+    execute(key: string, action: string, body: Record<string, unknown>, signal?: AbortSignal): Promise<CommandState>;
+    batch(keys: string[], action: string, body: Record<string, unknown>, broadcast?: boolean, signal?: AbortSignal, groupAddress?: number): Promise<BatchResult>;
+    snapshot(keys?: string[], includeFans?: boolean): Promise<Record<string, FixtureState>>;
+    stopEffects(keys: string[], signal?: AbortSignal): Promise<Record<string, FixtureState>>;
+    restore(states: Record<string, FixtureState>, signal?: AbortSignal): Promise<Record<string, FixtureState>>;
+    private restoreNow;
+    fade(keys: string[], brightness: unknown, seconds: unknown, signal?: AbortSignal): Promise<BatchResult>;
+    transition(keys: string[], action: string, body: Record<string, unknown>, seconds: number, signal?: AbortSignal): Promise<BatchResult>;
+    transitionScene(targets: Record<string, FixtureState>, seconds: number, signal?: AbortSignal): Promise<BatchResult>;
+    private steadyBody;
+    private transitionNow;
+    fan(key: string, mode?: unknown, signal?: AbortSignal, rpm?: unknown): Promise<FanState>;
+    fans(keys: string[], mode?: unknown, signal?: AbortSignal, rpm?: unknown): Promise<Record<string, FanState>>;
+    private validateFan;
+    private fanMatches;
+    private applyFan;
+    private prepare;
+    private matches;
+    private apply;
+    private readWithReconnect;
+    private readFanWithReconnect;
+    private telemetryWithReconnect;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/ble/controller.d.ts.map

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