amaran-light-cli 1.11.0 → 1.12.0

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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"}