@wms-js/lib 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Giuseppe Iannello
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,16 @@
+# @wms-js/lib
+
+Core library for the WMS radio protocol used by Warema motorised blinds and awnings.
+
+Provides frame parsing, serial abstractions, broadcast routing, and a `NetworkManager`
+for device discovery, status monitoring, and position control.
+
+## Install
+
+```sh
+npm install @wms-js/lib
+```
+
+## License
+
+MIT

package/dist/command/ack-match.d.ts

@@ -0,0 +1,5 @@
+import { type AckMatcher } from "./types.js";
+export declare const ackMatch: {
+    exact(type: string): AckMatcher;
+    prefix(prefix: string): AckMatcher;
+};

package/dist/command/ack-match.js

@@ -0,0 +1,9 @@
+export const ackMatch = {
+    exact(type) {
+        return (frame) => (frame === type ? "" : null);
+    },
+    prefix(prefix) {
+        return (frame) => (frame.startsWith(prefix) ? frame.slice(prefix.length) : null);
+    },
+};
+//# sourceMappingURL=ack-match.js.map

package/dist/command/ack-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ack-match.js","sourceRoot":"","sources":["../../src/command/ack-match.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,CAAC,IAAY;QAChB,OAAO,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACxD,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,OAAO,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAC1F,CAAC;CACF,CAAA"}

package/dist/command/session.d.ts

@@ -0,0 +1,23 @@
+import { type SendResult, type SessionOptions } from "./types.js";
+export declare class CommandSession {
+    readonly command: string;
+    readonly ack: Promise<SendResult>;
+    readonly promise: Promise<unknown>;
+    /** @internal called by RadioController when session completes */
+    _onDone: (() => void) | null;
+    private resolveAck;
+    private readonly responseHandlers;
+    private responseWindow;
+    private responseWindowTimer;
+    private cancelled;
+    private resolveDone;
+    private readonly options;
+    constructor(command: string, options: SessionOptions);
+    /** @internal called by RadioController when session becomes active */
+    _startAckTimer(): void;
+    onResponse(handler: (frame: string) => void): () => void;
+    feedFrame(frame: string): boolean;
+    cancel(): void;
+    private closeResponseWindow;
+    private finish;
+}

package/dist/command/session.js

@@ -0,0 +1,98 @@
+export class CommandSession {
+    command;
+    ack;
+    promise;
+    /** @internal called by RadioController when session completes */
+    _onDone = null;
+    resolveAck = null;
+    responseHandlers = new Set();
+    responseWindow = false;
+    responseWindowTimer = null;
+    cancelled = false;
+    resolveDone = null;
+    options;
+    constructor(command, options) {
+        this.command = command;
+        this.options = {
+            ackTimeoutMs: 100,
+            responseWindowMs: 500,
+            ...options,
+        };
+        this.ack = new Promise((resolve) => {
+            this.resolveAck = resolve;
+        });
+        this.promise = new Promise((resolve) => {
+            this.resolveDone = resolve;
+        });
+        this.promise.then(() => this._onDone?.());
+    }
+    /** @internal called by RadioController when session becomes active */
+    _startAckTimer() {
+        setTimeout(() => {
+            if (this.cancelled || this.responseWindow)
+                return;
+            this.resolveAck?.({ kind: "timeout" });
+            this.cancel();
+        }, this.options.ackTimeoutMs);
+    }
+    onResponse(handler) {
+        this.responseHandlers.add(handler);
+        return () => {
+            this.responseHandlers.delete(handler);
+        };
+    }
+    feedFrame(frame) {
+        if (this.cancelled)
+            return false;
+        if (frame === "f") {
+            this.resolveAck?.({ kind: "fail" });
+            this.cancel();
+            return true;
+        }
+        if (!this.responseWindow) {
+            const stripped = this.options.ackMatcher(frame);
+            if (stripped !== null) {
+                if (this.options.responseWindowMs !== undefined && this.options.responseWindowMs > 0) {
+                    this.responseWindow = true;
+                    this.resolveAck?.({ kind: "ack", frame: stripped });
+                    this.responseWindowTimer = setTimeout(() => {
+                        this.closeResponseWindow();
+                    }, this.options.responseWindowMs);
+                }
+                else {
+                    this.resolveAck?.({ kind: "ack", frame: stripped });
+                    this.cancel();
+                }
+                return true;
+            }
+            return false;
+        }
+        for (const handler of this.responseHandlers) {
+            handler(frame);
+        }
+        return true;
+    }
+    cancel() {
+        if (this.cancelled)
+            return;
+        this.cancelled = true;
+        this.responseHandlers.clear();
+        if (this.responseWindowTimer !== null) {
+            clearTimeout(this.responseWindowTimer);
+            this.responseWindowTimer = null;
+        }
+        if (!this.responseWindow) {
+            this.resolveAck?.({ kind: "timeout" });
+        }
+        this.finish();
+    }
+    closeResponseWindow() {
+        this.responseWindow = false;
+        this.finish();
+    }
+    finish() {
+        this.resolveDone?.();
+        this.resolveDone = null;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/command/session.js.map

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

package/dist/command/types.d.ts

@@ -0,0 +1,14 @@
+export type AckMatcher = (frame: string) => string | null;
+export interface SessionOptions {
+    ackMatcher: AckMatcher;
+    ackTimeoutMs?: number;
+    responseWindowMs?: number;
+}
+export type SendResult = {
+    kind: "ack";
+    frame: string;
+} | {
+    kind: "fail";
+} | {
+    kind: "timeout";
+};

package/dist/command/types.js

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

package/dist/command/types.js.map

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

package/dist/commands/name.d.ts

@@ -0,0 +1,25 @@
+import { RadioController } from "../controller.js";
+import type { DeviceScanResponse } from "../parsers/device-scan-response.js";
+import type { DeviceStatus } from "../parsers/device-status.js";
+export interface NetworkParams {
+    receiveBroadcasts: boolean;
+    channel: number;
+    panId: string;
+}
+export declare class Commands {
+    private radio;
+    constructor(radio: RadioController);
+    getName(): Promise<string>;
+    getVersion(): Promise<string>;
+    setNetworkParameters(params: NetworkParams): Promise<void>;
+    setEncryptionKey(key: string): Promise<void>;
+    scanNetwork(panId: string, timeoutMs?: number): Promise<DeviceScanResponse[]>;
+    getDeviceStatus(serialNumber: string, timeoutMs?: number): Promise<DeviceStatus>;
+    waveDevice(serialNumber: string, timeoutMs?: number): Promise<{
+        serialNumber: string;
+        code?: string;
+    }>;
+    stopDevice(serialNumber: string, timeoutMs?: number): Promise<void>;
+    moveToPosition(serialNumber: string, position: number, inclination?: number, timeoutMs?: number): Promise<void>;
+    private sendMoveCommand;
+}

package/dist/commands/name.js

@@ -0,0 +1,209 @@
+import { ackMatch } from "../command/ack-match.js";
+import { deviceScanResponseMatcher } from "../parsers/device-scan-response.js";
+import { deviceStatusMatcher } from "../parsers/device-status.js";
+import { waveResponseMatcher } from "../parsers/wave-response.js";
+import { waveRequestMatcher } from "../parsers/wave-request.js";
+export class Commands {
+    radio;
+    constructor(radio) {
+        this.radio = radio;
+    }
+    async getName() {
+        const session = this.radio.send("G", {
+            ackMatcher: ackMatch.prefix("g"),
+            responseWindowMs: 0,
+        });
+        const ack = await session.ack;
+        if (ack.kind === "timeout") {
+            throw new Error("getName: ack timeout");
+        }
+        if (ack.kind === "fail") {
+            throw new Error("getName: command rejected");
+        }
+        return ack.frame;
+    }
+    async getVersion() {
+        const session = this.radio.send("V", {
+            ackMatcher: ackMatch.prefix("v"),
+            responseWindowMs: 0,
+        });
+        const ack = await session.ack;
+        if (ack.kind === "timeout") {
+            throw new Error("getVersion: ack timeout");
+        }
+        if (ack.kind === "fail") {
+            throw new Error("getVersion: command rejected");
+        }
+        return ack.frame.trim();
+    }
+    async setNetworkParameters(params) {
+        if (params.channel < 11 || params.channel > 26) {
+            throw new Error("setNetworkParameters: invalid channel");
+        }
+        if (!/^[0-9A-Fa-f]{4}$/.test(params.panId)) {
+            throw new Error("setNetworkParameters: invalid PAN ID");
+        }
+        const modeChar = params.receiveBroadcasts ? "%" : "#";
+        const panId = params.panId.toUpperCase();
+        const frame = `M ${modeChar} ${params.channel} ${panId}`;
+        const session = this.radio.send(frame, {
+            ackMatcher: ackMatch.exact("a"),
+            responseWindowMs: 0,
+        });
+        const ack = await session.ack;
+        if (ack.kind === "fail") {
+            throw new Error("setNetworkParameters: command rejected");
+        }
+        if (ack.kind === "timeout") {
+            throw new Error("setNetworkParameters: ack timeout");
+        }
+    }
+    async setEncryptionKey(key) {
+        if (!/^[0-9A-Fa-f]{32}$/.test(key)) {
+            throw new Error("setEncryptionKey: invalid key");
+        }
+        const frame = `K 401 ${key.toUpperCase()}`;
+        const session = this.radio.send(frame, {
+            ackMatcher: ackMatch.exact("a"),
+            responseWindowMs: 0,
+        });
+        const ack = await session.ack;
+        if (ack.kind === "fail") {
+            throw new Error("setEncryptionKey: command rejected");
+        }
+        if (ack.kind === "timeout") {
+            throw new Error("setEncryptionKey: ack timeout");
+        }
+    }
+    // NOTE: responseWindowMs consumes ALL serial frames during the scan window,
+    // suppressing broadcast handlers (weather station, pairing, etc.). This is
+    // acceptable because scanning is infrequent and short-lived (~3s).
+    async scanNetwork(panId, timeoutMs = 3000) {
+        if (!/^[0-9A-Fa-f]{4}$/.test(panId)) {
+            throw new Error("scanNetwork: invalid PAN ID");
+        }
+        const seen = new Map();
+        const frame = `R04FFFFFF7020${panId.toUpperCase()}02`;
+        const session = this.radio.send(frame, {
+            ackMatcher: ackMatch.exact("a"),
+            responseWindowMs: timeoutMs,
+        });
+        session.onResponse((content) => {
+            const parsed = deviceScanResponseMatcher(content);
+            if (parsed && !seen.has(parsed.serialNumber)) {
+                seen.set(parsed.serialNumber, parsed);
+            }
+        });
+        const ack = await session.ack;
+        if (ack.kind === "fail") {
+            throw new Error("scanNetwork: command rejected");
+        }
+        if (ack.kind === "timeout") {
+            throw new Error("scanNetwork: ack timeout");
+        }
+        await session.promise;
+        return [...seen.values()];
+    }
+    async getDeviceStatus(serialNumber, timeoutMs = 2000) {
+        if (!/^[0-9A-Fa-f]{6}$/.test(serialNumber)) {
+            throw new Error("getDeviceStatus: invalid serial number");
+        }
+        const frame = `R06${serialNumber.toUpperCase()}801001000005`;
+        const session = this.radio.send(frame, {
+            ackMatcher: ackMatch.exact("a"),
+            responseWindowMs: timeoutMs,
+        });
+        let result = null;
+        session.onResponse((content) => {
+            const parsed = deviceStatusMatcher(content);
+            if (parsed && !result) {
+                result = parsed;
+                session.cancel();
+            }
+        });
+        const ack = await session.ack;
+        if (ack.kind === "fail") {
+            throw new Error("getDeviceStatus: command rejected");
+        }
+        if (ack.kind === "timeout") {
+            throw new Error("getDeviceStatus: ack timeout");
+        }
+        await session.promise;
+        if (!result) {
+            throw new Error("getDeviceStatus: no response from device");
+        }
+        return result;
+    }
+    async waveDevice(serialNumber, timeoutMs = 2000) {
+        if (!/^[0-9A-Fa-f]{6}$/.test(serialNumber)) {
+            throw new Error("waveDevice: invalid serial number");
+        }
+        const serial = serialNumber.toUpperCase();
+        const frame = `R06${serial}7050`;
+        const session = this.radio.send(frame, {
+            ackMatcher: ackMatch.exact("a"),
+            responseWindowMs: timeoutMs,
+        });
+        let result = null;
+        session.onResponse((content) => {
+            if (result)
+                return;
+            const wr = waveResponseMatcher(content);
+            if (wr && wr.serialNumber === serial) {
+                result = { serialNumber: wr.serialNumber, code: wr.code };
+                session.cancel();
+                return;
+            }
+            const wr2 = waveRequestMatcher(content);
+            if (wr2 && wr2.serialNumber === serial) {
+                result = { serialNumber: wr2.serialNumber };
+                session.cancel();
+            }
+        });
+        const ack = await session.ack;
+        if (ack.kind === "fail") {
+            throw new Error("waveDevice: command rejected");
+        }
+        if (ack.kind === "timeout") {
+            throw new Error("waveDevice: ack timeout");
+        }
+        await session.promise;
+        if (!result) {
+            throw new Error("waveDevice: no response from device");
+        }
+        return result;
+    }
+    async stopDevice(serialNumber, timeoutMs = 2000) {
+        if (!/^[0-9A-Fa-f]{6}$/.test(serialNumber)) {
+            throw new Error("stopDevice: invalid serial number");
+        }
+        const cmd = `R06${serialNumber.toUpperCase()}707001`;
+        return this.sendMoveCommand(cmd, timeoutMs);
+    }
+    async moveToPosition(serialNumber, position, inclination = 0, timeoutMs = 2000) {
+        if (!/^[0-9A-Fa-f]{6}$/.test(serialNumber)) {
+            throw new Error("moveToPosition: invalid serial number");
+        }
+        if (position < 0 || position > 100) {
+            throw new Error("moveToPosition: position must be 0-100");
+        }
+        const pp = Math.round(position * 2).toString(16).toUpperCase().padStart(2, "0");
+        const ww = Math.round(inclination + 127).toString(16).toUpperCase().padStart(2, "0");
+        const cmd = `R06${serialNumber.toUpperCase()}707003${pp}${ww}0000`;
+        return this.sendMoveCommand(cmd, timeoutMs);
+    }
+    async sendMoveCommand(rawCommand, timeoutMs) {
+        const session = this.radio.send(rawCommand, {
+            ackMatcher: ackMatch.exact("a"),
+            responseWindowMs: 0,
+        });
+        const ack = await session.ack;
+        if (ack.kind === "fail") {
+            throw new Error(`${rawCommand.startsWith("R06") && rawCommand.includes("707001") ? "stopDevice" : "moveToPosition"}: command rejected`);
+        }
+        if (ack.kind === "timeout") {
+            throw new Error(`${rawCommand.startsWith("R06") && rawCommand.includes("707001") ? "stopDevice" : "moveToPosition"}: ack timeout`);
+        }
+    }
+}
+//# sourceMappingURL=name.js.map

package/dist/commands/name.js.map

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

package/dist/controller.d.ts

@@ -0,0 +1,26 @@
+import { CommandSession } from "./command/session.js";
+import { type SessionOptions } from "./command/types.js";
+import { type SerialDriver } from "./serial/driver.js";
+export declare class RadioController {
+    private driver;
+    private parser;
+    private queue;
+    private activeOp;
+    private broadcastHandlers;
+    private errorHandlers;
+    private unsubs;
+    private _isOpen;
+    constructor(driver: SerialDriver);
+    get isOpen(): boolean;
+    open(path: string): Promise<void>;
+    close(): Promise<void>;
+    send(command: string, options: SessionOptions): CommandSession;
+    onBroadcast(handler: (frame: string) => void): () => void;
+    onError(handler: (error: Error) => void): () => void;
+    private processQueue;
+    private onSerialData;
+    private routeFrame;
+    private cancelActiveOp;
+    private emitError;
+    private onSerialClose;
+}

package/dist/controller.js

@@ -0,0 +1,108 @@
+import { FrameParser } from "./frame/parser.js";
+import { serializeFrame } from "./frame/serializer.js";
+import { CommandSession } from "./command/session.js";
+import { debug } from "./logging/logger.js";
+export class RadioController {
+    driver;
+    parser = new FrameParser();
+    queue = [];
+    activeOp = null;
+    broadcastHandlers = new Set();
+    errorHandlers = new Set();
+    unsubs = [];
+    _isOpen = false;
+    constructor(driver) {
+        this.driver = driver;
+        this.parser.onMalformedFrame((error) => {
+            this.emitError(error);
+        });
+    }
+    get isOpen() {
+        return this._isOpen;
+    }
+    async open(path) {
+        await this.driver.open(path);
+        this._isOpen = true;
+        this.unsubs.push(this.driver.onData((data) => this.onSerialData(data)));
+        this.unsubs.push(this.driver.onError((error) => this.emitError(error)));
+        this.unsubs.push(this.driver.onClose(() => this.onSerialClose()));
+    }
+    async close() {
+        this.cancelActiveOp();
+        for (const op of this.queue) {
+            op.cancel();
+        }
+        this.queue = [];
+        for (const unsub of this.unsubs) {
+            unsub();
+        }
+        this.unsubs = [];
+        this._isOpen = false;
+        await this.driver.close();
+    }
+    send(command, options) {
+        const session = new CommandSession(command, options);
+        session._onDone = () => {
+            if (this.activeOp === session) {
+                this.activeOp = null;
+                this.processQueue();
+            }
+        };
+        this.queue.push(session);
+        this.processQueue();
+        return session;
+    }
+    onBroadcast(handler) {
+        this.broadcastHandlers.add(handler);
+        return () => { this.broadcastHandlers.delete(handler); };
+    }
+    onError(handler) {
+        this.errorHandlers.add(handler);
+        return () => { this.errorHandlers.delete(handler); };
+    }
+    processQueue() {
+        if (this.activeOp !== null || this.queue.length === 0)
+            return;
+        const op = this.queue.shift();
+        this.activeOp = op;
+        op._startAckTimer();
+        const raw = serializeFrame(op.command);
+        debug(">>", op.command);
+        this.driver.write(raw);
+    }
+    onSerialData(data) {
+        const frames = this.parser.feed(data);
+        for (const frame of frames) {
+            this.routeFrame(frame);
+        }
+    }
+    routeFrame(frame) {
+        if (this.activeOp !== null) {
+            const consumed = this.activeOp.feedFrame(frame);
+            if (consumed) {
+                debug("<<", `${frame}  (session: ${this.activeOp.command})`);
+                return;
+            }
+        }
+        debug("<<", `${frame}  (broadcast)`);
+        for (const handler of this.broadcastHandlers) {
+            handler(frame);
+        }
+    }
+    cancelActiveOp() {
+        if (this.activeOp !== null) {
+            this.activeOp.cancel();
+            this.activeOp = null;
+        }
+    }
+    emitError(error) {
+        for (const handler of this.errorHandlers) {
+            handler(error);
+        }
+    }
+    onSerialClose() {
+        this.cancelActiveOp();
+        this._isOpen = false;
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

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

package/dist/frame/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class MalformedFrameError extends Error {
+    readonly partial: string;
+    constructor(partial: string);
+}

package/dist/frame/errors.js

@@ -0,0 +1,9 @@
+export class MalformedFrameError extends Error {
+    partial;
+    constructor(partial) {
+        super(`Malformed frame: no closing brace within timeout`);
+        this.name = "MalformedFrameError";
+        this.partial = partial;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/frame/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/frame/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,OAAO,CAAQ;IAExB,YAAY,OAAe;QACzB,KAAK,CAAC,kDAAkD,CAAC,CAAA;QACzD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;CACF"}

package/dist/frame/parser.d.ts

@@ -0,0 +1,13 @@
+import { MalformedFrameError } from "./errors.js";
+export declare class FrameParser {
+    private buffer;
+    private malformedHandler;
+    private malformedTimer;
+    private readonly partialTimeoutMs;
+    constructor(partialTimeoutMs?: number);
+    onMalformedFrame(handler: (error: MalformedFrameError) => void): () => void;
+    feed(data: Uint8Array): string[];
+    reset(): void;
+    private startMalformedTimer;
+    private clearMalformedTimer;
+}