@mehrwiedu/dreo-api 0.1.0

package/dist/DreoDevice.js

@@ -0,0 +1,147 @@
+import { InputValidator } from "./InputValidator.js";
+import { StateConstraintValidator } from "./StateConstraintValidator.js";
+import { StateMapper } from "./StateMapper.js";
+export class DreoDevice {
+    device;
+    websocket;
+    stateConstraints;
+    currentState = {
+        raw: {},
+    };
+    stateMapper = new StateMapper();
+    stateConstraintValidator = new StateConstraintValidator();
+    constructor(device, websocket, stateConstraints = new Map(), initialRawState = {}) {
+        this.device = device;
+        this.websocket = websocket;
+        this.stateConstraints = stateConstraints;
+        if (Object.keys(initialRawState).length > 0) {
+            this.applyReport(initialRawState);
+        }
+    }
+    get sn() {
+        return this.device.sn;
+    }
+    get name() {
+        return this.device.deviceName;
+    }
+    get model() {
+        return this.device.model;
+    }
+    get state() {
+        return this.currentState;
+    }
+    /**
+     * @internal
+     *
+     * Applies an incoming DREO WebSocket report to the local state cache.
+     * This method is used internally by DreoClient.
+     */
+    applyReport(reported) {
+        this.currentState = {
+            ...this.currentState,
+            raw: {
+                ...this.currentState.raw,
+                ...reported,
+            },
+            power: this.readBoolean(reported, "poweron", this.currentState.power),
+            fan: this.readBoolean(reported, "fanon", this.currentState.fan),
+            mainLight: this.readBoolean(reported, "lighton", this.currentState.mainLight),
+            atmosphereLight: this.readBoolean(reported, "atmon", this.currentState.atmosphereLight),
+            mute: this.readBoolean(reported, "muteon", this.currentState.mute),
+            windLevel: this.readNumber(reported, "windlevel", this.currentState.windLevel),
+            mode: this.readNumber(reported, "mode", this.currentState.mode),
+            brightness: this.readNumber(reported, "brightness", this.currentState.brightness),
+            colorTemperature: this.readNumber(reported, "colortemp", this.currentState.colorTemperature),
+            rgbPreset: this.readNumber(reported, "rgbpresetsel", this.currentState.rgbPreset),
+            rgbEffectId: this.readString(reported, "rgbeffectid", this.currentState.rgbEffectId),
+            rssi: this.readUnknown(reported, "rssi", this.currentState.rssi),
+        };
+    }
+    async setPower(enabled) {
+        await this.applyStateChange({
+            power: enabled,
+        });
+    }
+    async setFan(enabled) {
+        await this.applyStateChange({
+            fan: enabled,
+        });
+    }
+    async setMainLight(enabled) {
+        await this.applyStateChange({
+            mainLight: enabled,
+        });
+    }
+    async setAtmosphereLight(enabled) {
+        await this.applyStateChange({
+            atmosphereLight: enabled,
+        });
+    }
+    async setWindLevel(level) {
+        InputValidator.requireWindLevel(level);
+        await this.applyStateChange({
+            windLevel: level,
+        });
+    }
+    async setBrightness(value) {
+        InputValidator.requirePercentage(value, "brightness");
+        await this.applyStateChange({
+            brightness: value,
+        });
+    }
+    async setColorTemperature(value) {
+        InputValidator.requirePercentage(value, "colorTemperature");
+        await this.applyStateChange({
+            colorTemperature: value,
+        });
+    }
+    async setRgbPreset(value) {
+        InputValidator.requireRgbPreset(value);
+        await this.applyStateChange({
+            rgbPreset: value,
+        });
+    }
+    async setAtmosphereBrightness(value) {
+        InputValidator.requirePercentage(value, "atmosphereBrightness");
+        await this.applyStateChange({
+            atmosphereBrightness: value,
+        });
+    }
+    async setMute(value) {
+        await this.setStates({
+            muteon: value,
+        });
+    }
+    async applyStateChange(change) {
+        const payload = this.stateMapper.build(this.currentState, change);
+        await this.setStates(payload);
+    }
+    async setStates(params) {
+        this.validateStateParams(params);
+        const reply = await this.websocket.sendCommandParams(this.sn, params);
+        if (reply.reported) {
+            this.applyReport(reply.reported);
+        }
+    }
+    validateStateParams(params) {
+        for (const [stateKey, value] of Object.entries(params)) {
+            this.stateConstraintValidator.validate(stateKey, value, this.stateConstraints.get(stateKey));
+        }
+    }
+    readBoolean(source, key, fallback) {
+        const value = source[key];
+        return typeof value === "boolean" ? value : fallback;
+    }
+    readNumber(source, key, fallback) {
+        const value = source[key];
+        return typeof value === "number" ? value : fallback;
+    }
+    readString(source, key, fallback) {
+        const value = source[key];
+        return typeof value === "string" ? value : fallback;
+    }
+    readUnknown(source, key, fallback) {
+        return key in source ? source[key] : fallback;
+    }
+}
+//# sourceMappingURL=DreoDevice.js.map

package/dist/DreoDevice.js.map

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

package/dist/DreoLogger.d.ts

@@ -0,0 +1,7 @@
+export interface DreoLogger {
+    debug?(message: string, data?: unknown): void;
+    info?(message: string, data?: unknown): void;
+    warn?(message: string, data?: unknown): void;
+    error?(message: string, data?: unknown): void;
+}
+export declare const noopDreoLogger: Required<DreoLogger>;

package/dist/DreoLogger.js

@@ -0,0 +1,15 @@
+export const noopDreoLogger = {
+    debug() {
+        // intentionally empty
+    },
+    info() {
+        // intentionally empty
+    },
+    warn() {
+        // intentionally empty
+    },
+    error() {
+        // intentionally empty
+    },
+};
+//# sourceMappingURL=DreoLogger.js.map

package/dist/DreoLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DreoLogger.js","sourceRoot":"","sources":["../src/DreoLogger.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,cAAc,GAAyB;IAChD,KAAK;QACD,sBAAsB;IAC1B,CAAC;IAED,IAAI;QACA,sBAAsB;IAC1B,CAAC;IAED,IAAI;QACA,sBAAsB;IAC1B,CAAC;IAED,KAAK;QACD,sBAAsB;IAC1B,CAAC;CACJ,CAAC"}

package/dist/DreoSession.d.ts

@@ -0,0 +1,31 @@
+import type { AuthTokens } from "./models/AuthTokens.js";
+import type { DreoLogger } from "./DreoLogger.js";
+import type { DreoSessionObserver } from "./DreoSessionObserver.js";
+export interface DreoSessionOptions {
+    email: string;
+    password: string;
+    region: string;
+    logger?: DreoLogger;
+}
+export type DreoSessionTokenHandler = (tokens: AuthTokens) => void;
+export declare class DreoSession {
+    private readonly options;
+    private tokens?;
+    private readonly authManager;
+    private readonly tokenHandlers;
+    private readonly observers;
+    constructor(options: DreoSessionOptions);
+    login(): Promise<AuthTokens>;
+    refresh(): Promise<AuthTokens>;
+    getAccessToken(): Promise<string>;
+    getRegion(): string | undefined;
+    getCurrentTokens(): AuthTokens | undefined;
+    onTokenChanged(handler: DreoSessionTokenHandler): () => void;
+    addObserver(observer: DreoSessionObserver): void;
+    removeObserver(observer: DreoSessionObserver): void;
+    setAccessTokenForTesting(accessToken: string): void;
+    private loginWithReason;
+    private emitTokenChange;
+    private emitSessionChanged;
+    private createSnapshot;
+}

package/dist/DreoSession.js

@@ -0,0 +1,81 @@
+import { AuthManager } from "./auth/AuthManager.js";
+export class DreoSession {
+    options;
+    tokens;
+    authManager;
+    tokenHandlers = new Set();
+    observers = new Set();
+    constructor(options) {
+        this.options = options;
+        this.authManager = new AuthManager({
+            logger: options.logger,
+        });
+    }
+    async login() {
+        return this.loginWithReason("initial-login");
+    }
+    async refresh() {
+        return this.loginWithReason("http-401-relogin");
+    }
+    async getAccessToken() {
+        if (!this.tokens) {
+            await this.login();
+        }
+        return this.tokens.accessToken;
+    }
+    getRegion() {
+        return this.tokens?.region;
+    }
+    getCurrentTokens() {
+        return this.tokens;
+    }
+    onTokenChanged(handler) {
+        this.tokenHandlers.add(handler);
+        return () => {
+            this.tokenHandlers.delete(handler);
+        };
+    }
+    addObserver(observer) {
+        this.observers.add(observer);
+    }
+    removeObserver(observer) {
+        this.observers.delete(observer);
+    }
+    setAccessTokenForTesting(accessToken) {
+        if (!this.tokens) {
+            throw new Error("No active session.");
+        }
+        this.tokens = {
+            ...this.tokens,
+            accessToken,
+        };
+        this.emitTokenChange(this.tokens);
+    }
+    async loginWithReason(reason) {
+        this.tokens = await this.authManager.login(this.options);
+        this.emitTokenChange(this.tokens);
+        await this.emitSessionChanged(this.tokens, reason);
+        return this.tokens;
+    }
+    emitTokenChange(tokens) {
+        for (const handler of Array.from(this.tokenHandlers)) {
+            handler(tokens);
+        }
+    }
+    async emitSessionChanged(tokens, reason) {
+        const snapshot = this.createSnapshot(tokens);
+        await Promise.all(Array.from(this.observers).map(async (observer) => {
+            await observer.onSessionChanged?.(snapshot, reason);
+        }));
+    }
+    createSnapshot(tokens) {
+        const extendedTokens = tokens;
+        return {
+            accessToken: tokens.accessToken,
+            refreshToken: extendedTokens.refreshToken,
+            region: tokens.region,
+            accountId: extendedTokens.accountId,
+        };
+    }
+}
+//# sourceMappingURL=DreoSession.js.map

package/dist/DreoSession.js.map

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

package/dist/DreoSessionObserver.d.ts

@@ -0,0 +1,12 @@
+export type DreoRegion = "EU" | "US" | "CN" | string;
+export interface DreoSessionSnapshot {
+    accessToken: string;
+    refreshToken?: string;
+    region: DreoRegion;
+    accountId?: string;
+}
+export type DreoSessionChangeReason = "initial-login" | "http-401-relogin" | "manual-relogin" | "logout";
+export interface DreoSessionObserver {
+    onSessionChanged?(snapshot: DreoSessionSnapshot, reason: DreoSessionChangeReason): void | Promise<void>;
+    onSessionInvalidated?(reason: DreoSessionChangeReason): void | Promise<void>;
+}

package/dist/DreoSessionObserver.js

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

package/dist/DreoSessionObserver.js.map

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

package/dist/DreoStateRegistry.d.ts

@@ -0,0 +1,3 @@
+import type { DiscoveredState } from "./models/DiscoveredState.js";
+export type DreoStateDefinition = Omit<DiscoveredState, "key" | "valueType">;
+export declare const DREO_STATE_REGISTRY: Record<string, DreoStateDefinition>;

package/dist/DreoStateRegistry.js

@@ -0,0 +1,302 @@
+export const DREO_STATE_REGISTRY = {
+    // --------------------------------------------------
+    // Control
+    // --------------------------------------------------
+    poweron: {
+        known: true,
+        writable: true,
+        category: "control",
+        description: "Device power",
+        constraint: {
+            type: "boolean",
+        },
+    },
+    fanon: {
+        known: true,
+        writable: true,
+        category: "control",
+        description: "Fan power",
+        constraint: {
+            type: "boolean",
+        },
+    },
+    lighton: {
+        known: true,
+        writable: true,
+        category: "control",
+        description: "Light power",
+        constraint: {
+            type: "boolean",
+        },
+    },
+    atmon: {
+        known: true,
+        writable: true,
+        category: "control",
+        description: "Ambient light power",
+        constraint: {
+            type: "boolean",
+        },
+    },
+    brightness: {
+        known: true,
+        writable: true,
+        category: "control",
+        description: "Light brightness",
+        constraint: {
+            type: "number",
+            min: 0,
+            max: 100,
+            step: 1,
+        },
+    },
+    atmbri: {
+        known: true,
+        writable: true,
+        category: "control",
+        description: "Ambient light brightness",
+        constraint: {
+            type: "number",
+            min: 0,
+            max: 100,
+            step: 1,
+        },
+    },
+    colortemp: {
+        known: true,
+        writable: true,
+        category: "control",
+        description: "Color temperature",
+        constraint: {
+            type: "number",
+            min: 0,
+            max: 100,
+            step: 1,
+        },
+    },
+    mode: {
+        known: true,
+        writable: true,
+        category: "control",
+        description: "Operating mode",
+        constraint: {
+            type: "number",
+            step: 1,
+        },
+    },
+    windlevel: {
+        known: true,
+        writable: true,
+        category: "control",
+        description: "Fan speed",
+        constraint: {
+            type: "number",
+            min: 1,
+            max: 12,
+            step: 1,
+        },
+    },
+    oscmode: {
+        known: true,
+        writable: true,
+        category: "control",
+        description: "Oscillation mode",
+        constraint: {
+            type: "number",
+            step: 1,
+        },
+    },
+    rgbpresetsel: {
+        known: true,
+        writable: true,
+        category: "control",
+        description: "RGB preset selection",
+        constraint: {
+            type: "number",
+            min: 0,
+            max: 4,
+            step: 1,
+        },
+    },
+    // --------------------------------------------------
+    // Configuration
+    // --------------------------------------------------
+    muteon: {
+        known: true,
+        writable: true,
+        category: "configuration",
+        description: "Button sound",
+        constraint: {
+            type: "boolean",
+        },
+    },
+    childlockon: {
+        known: true,
+        writable: true,
+        category: "configuration",
+        description: "Child lock",
+        constraint: {
+            type: "boolean",
+        },
+    },
+    // --------------------------------------------------
+    // Diagnostic
+    // --------------------------------------------------
+    connected: {
+        known: true,
+        writable: false,
+        category: "diagnostic",
+        description: "Cloud connectivity",
+        constraint: {
+            type: "boolean",
+        },
+    },
+    wifi_rssi: {
+        known: true,
+        writable: false,
+        category: "diagnostic",
+        description: "WiFi signal",
+        constraint: {
+            type: "number",
+        },
+    },
+    wifi_ssid: {
+        known: true,
+        writable: false,
+        category: "diagnostic",
+        description: "Connected WiFi",
+        constraint: {
+            type: "string",
+        },
+    },
+    network_latency: {
+        known: true,
+        writable: false,
+        category: "diagnostic",
+        description: "Cloud latency",
+        constraint: {
+            type: "number",
+        },
+    },
+    module_firmware_version: {
+        known: true,
+        writable: false,
+        category: "diagnostic",
+        description: "Module firmware",
+        constraint: {
+            type: "string",
+        },
+    },
+    mcu_firmware_version: {
+        known: true,
+        writable: false,
+        category: "diagnostic",
+        description: "MCU firmware",
+        constraint: {
+            type: "string",
+        },
+    },
+    module_hardware_model: {
+        known: true,
+        writable: false,
+        category: "diagnostic",
+        description: "Module hardware",
+        constraint: {
+            type: "string",
+        },
+    },
+    mcu_hardware_model: {
+        known: true,
+        writable: false,
+        category: "diagnostic",
+        description: "MCU hardware",
+        constraint: {
+            type: "string",
+        },
+    },
+    // --------------------------------------------------
+    // Informational (bekannt, aber Bedeutung noch nicht vollständig geklärt)
+    // --------------------------------------------------
+    timeron: {
+        known: true,
+        writable: false,
+        category: "information",
+        description: "Timer configuration",
+        constraint: {
+            type: "object",
+        },
+    },
+    timeroff: {
+        known: true,
+        writable: false,
+        category: "information",
+        description: "Timer configuration",
+        constraint: {
+            type: "object",
+        },
+    },
+    temperature: {
+        known: true,
+        writable: false,
+        category: "information",
+        description: "Measured temperature",
+        constraint: {
+            type: "number",
+        },
+    },
+    cruiseconf: {
+        known: true,
+        writable: false,
+        category: "information",
+        description: "Cruise mode configuration",
+        constraint: {
+            type: "string",
+        },
+    },
+    fixedconf: {
+        known: true,
+        writable: false,
+        category: "information",
+        description: "Fixed mode configuration",
+        constraint: {
+            type: "string",
+        },
+    },
+    rgbeffectid: {
+        known: true,
+        writable: false,
+        category: "information",
+        description: "Selected RGB effect",
+        constraint: {
+            type: "string",
+        },
+    },
+    rgbpresetnum: {
+        known: true,
+        writable: false,
+        category: "information",
+        description: "Available RGB presets",
+        constraint: {
+            type: "number",
+        },
+    },
+    scenes: {
+        known: true,
+        writable: false,
+        category: "information",
+        description: "Scene configuration",
+        constraint: {
+            type: "string",
+        },
+    },
+    module_hardware_mac: {
+        known: true,
+        writable: false,
+        category: "information",
+        description: "Module MAC address",
+        constraint: {
+            type: "string",
+        },
+    },
+};
+//# sourceMappingURL=DreoStateRegistry.js.map

package/dist/DreoStateRegistry.js.map

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

package/dist/InputValidator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Legacy fallback validator for typed convenience methods.
+ *
+ * Device-specific command validation is handled by StateConstraintValidator
+ * inside DreoDevice before a command is sent.
+ *
+ * This class remains intentionally simple and provides broad SDK defaults for
+ * typed setters that predate resolved device constraints.
+ */
+export declare class InputValidator {
+    static requirePercentage(value: number, name?: string): void;
+    static requireWindLevel(value: number): void;
+    static requireRgbPreset(value: number): void;
+    static requireRange(value: number, min: number, max: number, name?: string): void;
+}