amaran-light-cli 1.10.0 → 1.12.0

package/dist/ble/nativeGroups.js

@@ -0,0 +1,114 @@
+import { changeSubscription, modelBindings, readComposition, readConfiguration, subscriptions, } from './configuration.js';
+export class NativeGroups {
+    config;
+    link;
+    library;
+    constructor(config, link, library) {
+        this.config = config;
+        this.link = link;
+        this.library = library;
+    }
+    async inspect() {
+        const result = [];
+        for (const light of this.config.lights) {
+            const data = await readComposition(this.link, light.address);
+            const model = data.models.find((item) => item.element === light.address && item.company === undefined && item.model === 0x1000);
+            if (!model || !(await modelBindings(this.link, light.address, model)).includes(0))
+                throw new Error(`${light.name}: no supported, bound native group model`);
+            const groups = await subscriptions(this.link, light.address, model);
+            const phase = await readConfiguration(this.link, light.address, Buffer.from([0x80, 0x15, 0, 0]), (data) => data.length === 6 && data[0] === 0x80 && data[1] === 0x17 && data.readUInt16LE(3) === 0);
+            if (phase[2] !== 0)
+                throw new Error(`${light.name}: key-refresh phase query failed (${phase[2]})`);
+            result.push({
+                key: light.key,
+                address: light.address,
+                composition: data,
+                model,
+                groups,
+                keyRefreshPhase: phase[5],
+            });
+        }
+        return result;
+    }
+    async enable(key, address) {
+        let group = this.library.group(key);
+        if (!group.members.length)
+            throw new Error('A native group needs fixture members');
+        if (group.native)
+            throw new Error('Group already has native configuration; use sync or disable');
+        const actual = await this.inspect();
+        if (actual.some((item) => item.keyRefreshPhase !== 0))
+            throw new Error('Cannot configure groups during mesh key refresh');
+        const used = new Set([
+            ...actual.flatMap((item) => item.groups),
+            ...this.library.groups().flatMap((item) => (item.native ? [item.native.address] : [])),
+        ]);
+        let selected = address ?? 0xc100;
+        if (address === undefined)
+            while (used.has(selected) && selected <= 0xfeff)
+                selected++;
+        if (!Number.isInteger(selected) || selected < 0xc000 || selected > 0xfeff || used.has(selected))
+            throw new Error('Choose an unused group address in 0xc000-0xfeff');
+        for (const member of group.members)
+            if (!actual.some((item) => item.key === member))
+                throw new Error(`Unknown member ${member}`);
+        group = this.library.setNativeGroup(group.id, {
+            address: selected,
+            status: 'pending',
+            managed: actual.map((item) => item.key),
+        });
+        return this.sync(group.id, actual);
+    }
+    async sync(key, actual) {
+        const group = this.library.group(key);
+        if (!group.native)
+            throw new Error('Group has no native configuration');
+        this.library.setNativeGroup(group.id, { ...group.native, status: 'pending' });
+        const observations = actual ?? (await this.inspect());
+        if (observations.some((item) => item.keyRefreshPhase !== 0))
+            throw new Error('Cannot configure groups during mesh key refresh');
+        for (const member of [...group.native.managed, ...group.members])
+            if (!observations.some((item) => item.key === member))
+                throw new Error(`Native group member ${member} is unavailable`);
+        for (const item of observations) {
+            if (!group.native.managed.includes(item.key) && item.groups.includes(group.native.address))
+                throw new Error(`Unmanaged fixture ${item.key} already uses this group address`);
+        }
+        const managed = [...new Set([...group.native.managed, ...group.members])];
+        this.library.setNativeGroup(group.id, { ...group.native, managed, status: 'pending' });
+        for (const item of observations.filter((item) => managed.includes(item.key))) {
+            const desired = group.members.includes(item.key);
+            if (item.groups.includes(group.native.address) !== desired)
+                await changeSubscription(this.link, item.address, item.model, group.native.address, !desired);
+        }
+        return this.library.setNativeGroup(group.id, { ...group.native, managed, status: 'ready' });
+    }
+    async member(key, member, remove) {
+        const group = this.library.group(key);
+        if (!group.native)
+            throw new Error('Group is not native');
+        if (!this.config.lights.some((light) => light.key === member))
+            throw new Error(`Unknown fixture ${member}`);
+        this.library.setNativeGroup(group.id, { ...group.native, status: 'pending' });
+        this.library.updateGroup(group.id, member, remove);
+        return this.sync(group.id);
+    }
+    async disable(key) {
+        const group = this.library.group(key);
+        if (!group.native)
+            return group;
+        this.library.setNativeGroup(group.id, { ...group.native, status: 'pending' });
+        const observations = await this.inspect();
+        if (observations.some((item) => item.keyRefreshPhase !== 0))
+            throw new Error('Cannot configure groups during mesh key refresh');
+        for (const member of group.native.managed) {
+            const item = observations.find((entry) => entry.key === member);
+            if (!item)
+                throw new Error(`Cannot remove subscription from missing fixture ${member}`);
+            if (item.groups.includes(group.native.address))
+                await changeSubscription(this.link, item.address, item.model, group.native.address, true);
+        }
+        return this.library.setNativeGroup(group.id, undefined);
+    }
+}
+//# sourceMappingURL=nativeGroups.js.map

package/dist/ble/nativeGroups.js.map

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

package/dist/ble/packets.d.ts

@@ -0,0 +1,3 @@
+export declare function numberInRange(value: unknown, name: string, min: number, max: number): number;
+export declare function packet(type: number, bits?: bigint): Buffer;
+//# sourceMappingURL=packets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packets.d.ts","sourceRoot":"","sources":["../../src/ble/packets.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK5F;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,MAAM,CAOtD"}

package/dist/ble/packets.js

@@ -0,0 +1,15 @@
+export function numberInRange(value, name, min, max) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < min || value > max) {
+        throw new Error(`${name} must be a finite number between ${min} and ${max}`);
+    }
+    return value;
+}
+export function packet(type, bits = 0n) {
+    const data = Buffer.alloc(10);
+    data.writeBigUInt64LE(bits & 0xffffffffffffffffn);
+    data[8] = Number((bits >> 64n) & 255n);
+    data[9] = type;
+    data[0] = data.subarray(1).reduce((sum, value) => sum + value, 0) & 255;
+    return data;
+}
+//# sourceMappingURL=packets.js.map

package/dist/ble/packets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packets.js","sourceRoot":"","sources":["../../src/ble/packets.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,IAAY,EAAE,GAAW,EAAE,GAAW;IAClF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QACvF,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,oCAAoC,GAAG,QAAQ,GAAG,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAAI,GAAG,EAAE;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9B,IAAI,CAAC,gBAAgB,CAAC,IAAI,GAAG,mBAAmB,CAAC,CAAC;IAClD,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACf,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/ble/programs.d.ts

@@ -0,0 +1,318 @@
+import { z } from 'zod';
+import { type VerifiedController } from './controller.js';
+import { type MediaSample } from './media.js';
+export declare const ProgramSchema: z.ZodEffects<z.ZodObject<{
+    kind: z.ZodEnum<["timeline", "audio", "picker"]>;
+    targets: z.ZodUnion<[z.ZodLiteral<"all">, z.ZodArray<z.ZodString, "many">]>;
+    duration: z.ZodDefault<z.ZodNumber>;
+    restore: z.ZodDefault<z.ZodBoolean>;
+    maxBrightness: z.ZodDefault<z.ZodNumber>;
+    gain: z.ZodDefault<z.ZodNumber>;
+    source: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"samples">;
+        media: z.ZodEnum<["audio", "image"]>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "samples";
+        media: "audio" | "image";
+    }, {
+        kind: "samples";
+        media: "audio" | "image";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"audio-file">;
+        file: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "audio-file";
+        file: string;
+    }, {
+        kind: "audio-file";
+        file: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"microphone">;
+        device: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        kind: "microphone";
+        device: number;
+    }, {
+        kind: "microphone";
+        device: number;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"image-file">;
+        file: z.ZodString;
+        region: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        }, {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "image-file";
+        file: string;
+        region?: {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        } | undefined;
+    }, {
+        kind: "image-file";
+        file: string;
+        region?: {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        } | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"camera">;
+        device: z.ZodNumber;
+        region: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        }, {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "camera";
+        device: number;
+        region?: {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        } | undefined;
+    }, {
+        kind: "camera";
+        device: number;
+        region?: {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        } | undefined;
+    }>]>>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        at: z.ZodNumber;
+        action: z.ZodEnum<["cct", "hsi", "brightness", "color", "gm", "on", "off", "effect", "effect-stop"]>;
+        args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        at: number;
+        action: "cct" | "color" | "effect" | "hsi" | "off" | "on" | "brightness" | "gm" | "effect-stop";
+        args: Record<string, unknown>;
+    }, {
+        at: number;
+        action: "cct" | "color" | "effect" | "hsi" | "off" | "on" | "brightness" | "gm" | "effect-stop";
+        args: Record<string, unknown>;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    targets: string[] | "all";
+    kind: "audio" | "picker" | "timeline";
+    restore: boolean;
+    duration: number;
+    maxBrightness: number;
+    gain: number;
+    source?: {
+        kind: "samples";
+        media: "audio" | "image";
+    } | {
+        kind: "audio-file";
+        file: string;
+    } | {
+        kind: "microphone";
+        device: number;
+    } | {
+        kind: "image-file";
+        file: string;
+        region?: {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        } | undefined;
+    } | {
+        kind: "camera";
+        device: number;
+        region?: {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        } | undefined;
+    } | undefined;
+    steps?: {
+        at: number;
+        action: "cct" | "color" | "effect" | "hsi" | "off" | "on" | "brightness" | "gm" | "effect-stop";
+        args: Record<string, unknown>;
+    }[] | undefined;
+}, {
+    targets: string[] | "all";
+    kind: "audio" | "picker" | "timeline";
+    source?: {
+        kind: "samples";
+        media: "audio" | "image";
+    } | {
+        kind: "audio-file";
+        file: string;
+    } | {
+        kind: "microphone";
+        device: number;
+    } | {
+        kind: "image-file";
+        file: string;
+        region?: {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        } | undefined;
+    } | {
+        kind: "camera";
+        device: number;
+        region?: {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        } | undefined;
+    } | undefined;
+    restore?: boolean | undefined;
+    duration?: number | undefined;
+    maxBrightness?: number | undefined;
+    gain?: number | undefined;
+    steps?: {
+        at: number;
+        action: "cct" | "color" | "effect" | "hsi" | "off" | "on" | "brightness" | "gm" | "effect-stop";
+        args: Record<string, unknown>;
+    }[] | undefined;
+}>, {
+    targets: string[] | "all";
+    kind: "audio" | "picker" | "timeline";
+    restore: boolean;
+    duration: number;
+    maxBrightness: number;
+    gain: number;
+    source?: {
+        kind: "samples";
+        media: "audio" | "image";
+    } | {
+        kind: "audio-file";
+        file: string;
+    } | {
+        kind: "microphone";
+        device: number;
+    } | {
+        kind: "image-file";
+        file: string;
+        region?: {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        } | undefined;
+    } | {
+        kind: "camera";
+        device: number;
+        region?: {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        } | undefined;
+    } | undefined;
+    steps?: {
+        at: number;
+        action: "cct" | "color" | "effect" | "hsi" | "off" | "on" | "brightness" | "gm" | "effect-stop";
+        args: Record<string, unknown>;
+    }[] | undefined;
+}, {
+    targets: string[] | "all";
+    kind: "audio" | "picker" | "timeline";
+    source?: {
+        kind: "samples";
+        media: "audio" | "image";
+    } | {
+        kind: "audio-file";
+        file: string;
+    } | {
+        kind: "microphone";
+        device: number;
+    } | {
+        kind: "image-file";
+        file: string;
+        region?: {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        } | undefined;
+    } | {
+        kind: "camera";
+        device: number;
+        region?: {
+            y: number;
+            x: number;
+            width: number;
+            height: number;
+        } | undefined;
+    } | undefined;
+    restore?: boolean | undefined;
+    duration?: number | undefined;
+    maxBrightness?: number | undefined;
+    gain?: number | undefined;
+    steps?: {
+        at: number;
+        action: "cct" | "color" | "effect" | "hsi" | "off" | "on" | "brightness" | "gm" | "effect-stop";
+        args: Record<string, unknown>;
+    }[] | undefined;
+}>;
+export type Program = z.infer<typeof ProgramSchema>;
+export interface ProgramStatus {
+    id: string;
+    kind: Program['kind'];
+    targets: string[];
+    state: 'preparing' | 'running' | 'restoring' | 'completed' | 'cancelled' | 'failed';
+    startedAt: string;
+    frames: number;
+    error?: string;
+    lastSample?: MediaSample;
+}
+export declare class Programs {
+    private readonly controller;
+    private readonly targets;
+    private readonly jobs;
+    private closed;
+    private starts;
+    private readonly generations;
+    constructor(controller: Pick<VerifiedController, 'config' | 'snapshot' | 'override' | 'overrideStatus' | 'reserveControl' | 'batch' | 'restore'>, targets: (targets: Program['targets']) => string[]);
+    list(): ProgramStatus[];
+    get(id: string): ProgramStatus;
+    start(value: unknown): Promise<ProgramStatus>;
+    cancelTargets(keys: string[]): Promise<void>;
+    private cancelExisting;
+    stop(id: string): Promise<ProgramStatus>;
+    sample(id: string, value: unknown): void;
+    private inputSamples;
+    close(): Promise<void>;
+    private command;
+    private run;
+}
+//# sourceMappingURL=programs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"programs.d.ts","sourceRoot":"","sources":["../../src/ble/programs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,kBAAkB,EAAkB,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,KAAK,WAAW,EAAoE,MAAM,YAAY,CAAC;AAGhH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CtB,CAAC;AACL,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAYD,qBAAa,QAAQ;IAMjB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAI3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;gBAEtC,UAAU,EAAE,IAAI,CAC/B,kBAAkB,EAClB,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,OAAO,GAAG,SAAS,CAC/F,EACgB,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,MAAM,EAAE;IAGrE,IAAI,IAAI,aAAa,EAAE;IAGvB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa;IAKxB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAkE7C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAIpC,cAAc;IAatB,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAO9C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;YAczB,YAAY;IAgCrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,OAAO;YAMP,GAAG;CA6FlB"}