daikin-local-control 0.3.1 → 0.4.0

package/dist/simulators/simulator.d.ts

@@ -0,0 +1,116 @@
+import { type IncomingHttpHeaders } from "node:http";
+import type { DaikinDeviceInfo } from "../models/device.js";
+import type { DaikinSensors, DaikinState, SpecialMode } from "../models/state.js";
+/** One HTTP request a simulator received. */
+export interface DaikinSimulatorRequest {
+    method: string;
+    /** From the leading `/`, without the query string. */
+    path: string;
+    /** Percent-decoded. */
+    query: Record<string, string>;
+    headers: IncomingHttpHeaders;
+    body: string;
+}
+/** What `startClassicSimulator` and `startDsiotSimulator` both resolve with. */
+export interface DaikinSimulator {
+    /** `<address>:<port>`, as `DaikinDevice.host` takes it: `127.0.0.1`, unless
+     * the simulator was started at another `address`, and a port that was free
+     * when it started. */
+    readonly host: string;
+    /** Every request received, oldest first, the ones the simulator refused
+     * included. A request is added once its whole body has arrived, before it
+     * waits for its turn to be answered. */
+    readonly requests: DaikinSimulatorRequest[];
+    /** Changes the unit as its remote control would. A field left out, or
+     * `null`, stays as the unit holds it, and a new `mode` takes up what the
+     * unit remembers for that mode before the other fields are applied. It
+     * throws an `Error` for a field the unit has nothing to hold, such as a
+     * `verticalPosition` on a unit without fixed louver positions, and holds
+     * any other value as given, whether or not `getCapabilities` lists it. */
+    setState(state: Partial<DaikinState>): void;
+    /** Changes what the unit's sensors read. A reading left out stays as it is,
+     * and `null` is a reading the unit does not report. */
+    setSensors(sensors: Partial<DaikinSensors>): void;
+    /** Closes every connection and stops listening. A request still waiting is
+     * never answered. */
+    stop(): Promise<void>;
+}
+/** In °C. */
+export interface DaikinSimulatorTemperatures {
+    min: number;
+    max: number;
+}
+/** What a simulated unit has, where both protocols can say it. Anything else
+ * about a unit is set in the adapter's own terms: `modelInfo` on a classic
+ * simulator, and `leaves` on a DSIOT one. */
+export interface DaikinSimulatorUnit {
+    /** A unit that only cools offers dehumidify, cool and fan. Defaults to
+     * false: a heat pump, which offers auto and heat as well. */
+    coolingOnly?: boolean;
+    /** Whether the fan speed can be set. Defaults to true. */
+    fan?: boolean;
+    /** The axes the louvers swing on: `vertical` moves the air up and down
+     * alone, and `both` left and right as well. Defaults to `both`. */
+    swing?: "none" | "vertical" | "both";
+    /** The special modes the unit takes. Defaults to all three. */
+    specialModes?: readonly SpecialMode[];
+    /** The setpoints cool takes. A classic adapter reports whole degrees.
+     * Defaults to 18 to 32 on a DSIOT simulator, and to none reported on a
+     * classic one. */
+    coolTemperaturesInC?: DaikinSimulatorTemperatures;
+    /** The setpoints heat takes. A classic adapter reports whole degrees.
+     * Defaults to 10 to 30 on a DSIOT simulator, and to none reported on a
+     * classic one. */
+    heatTemperaturesInC?: DaikinSimulatorTemperatures;
+}
+/** The options `startClassicSimulator` and `startDsiotSimulator` both take.
+ * A simulator applies `deviceInfo`, `state` and `sensors` after the fields
+ * given in the adapter's own terms, so they replace a field given both
+ * ways. */
+export interface StartSimulatorOptions {
+    /** The adapter's name, MAC address and firmware version, as
+     * `getDeviceInfo` reads them back. A field left out keeps its default.
+     * Defaults to a name of `Simulator`. */
+    deviceInfo?: DaikinDeviceInfo;
+    /** The state the unit starts in: see `DaikinSimulator.setState`. Defaults
+     * to off, in cool at 24 °C on the auto fan speed, with nothing swinging
+     * and no special mode on. */
+    state?: Partial<DaikinState>;
+    /** What the unit's sensors read at the start: see
+     * `DaikinSimulator.setSensors`. Defaults to 26 °C and 55 % indoors, and
+     * 30 °C outdoors. */
+    sensors?: Partial<DaikinSensors>;
+    /** How long, in milliseconds, the adapter takes to answer a request. It
+     * answers one request at a time, in the order they arrive, so a request
+     * waits this long for each one ahead of it as well. Defaults to 0. */
+    replyDelayInMs?: number;
+    /** The address of this machine the adapter is at: it listens for HTTP
+     * there, and answers a discovery probe from there. Defaults to `127.0.0.1`,
+     * which nothing outside the machine reaches. */
+    address?: string;
+    /** Whether the adapter answers the discovery probe, so `discoverDevices`
+     * finds it at `host`. Defaults to false. Any number of simulators answer
+     * at once, in one process or several, and `discoverDevices` finds each at
+     * its own port. Starting one rejects with the socket's error only while a
+     * program that is not a simulator holds UDP port 30050. */
+    answersDiscovery?: boolean;
+}
+/** What `startSimulator` resolves with: the part of a `DaikinSimulator` that
+ * is the same for both protocols. */
+export type SimulatorServer = Pick<DaikinSimulator, "host" | "requests" | "stop">;
+export interface SimulatorReply {
+    statusCode: number;
+    body: string;
+}
+/** The reply to a request whose answer from an adapter is not known: HTTP 501,
+ * which no adapter is known to send, so a caller cannot take it for one. */
+export declare function unanswered(request: DaikinSimulatorRequest): SimulatorReply;
+/** Joins fields as a classic reply and a discovery reply carry them:
+ * `key=value` pairs separated by commas, `ret` first. */
+export declare function formatKeyValue(ret: string, fields?: Record<string, string>): string;
+/** Listens on a free port of `options.address` and answers each request with
+ * what `answer` returns for it, one request at a time. With
+ * `options.answersDiscovery`, it answers the discovery probe with
+ * `discoveryFields()` and the HTTP port, as `api_port`. */
+export declare function startSimulator(options: StartSimulatorOptions, answer: (request: DaikinSimulatorRequest) => SimulatorReply, discoveryFields: () => Record<string, string>): Promise<SimulatorServer>;
+//# sourceMappingURL=simulator.d.ts.map

package/dist/simulators/simulator.d.ts.map

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

package/dist/simulators/simulator.js

@@ -0,0 +1,141 @@
+import { createSocket } from "node:dgram";
+import { once } from "node:events";
+import { createServer } from "node:http";
+// What the classic and the DSIOT simulator share: the HTTP server, and the
+// reply to a discovery probe, which both adapters send in the same form.
+const DISCOVERY_PROBE = "DAIKIN_UDP/common/basic_info";
+const DISCOVERY_PORT = 30050;
+const DEFAULT_ADDRESS = "127.0.0.1";
+/** The reply to a request whose answer from an adapter is not known: HTTP 501,
+ * which no adapter is known to send, so a caller cannot take it for one. */
+export function unanswered(request) {
+    return {
+        statusCode: 501,
+        body: `The simulator does not answer ${request.method} ${request.path}`,
+    };
+}
+/** Joins fields as a classic reply and a discovery reply carry them:
+ * `key=value` pairs separated by commas, `ret` first. */
+export function formatKeyValue(ret, fields = {}) {
+    return Object.entries({ ret, ...fields })
+        .map(([name, value]) => `${name}=${value}`)
+        .join(",");
+}
+/** Listens on a free port of `options.address` and answers each request with
+ * what `answer` returns for it, one request at a time. With
+ * `options.answersDiscovery`, it answers the discovery probe with
+ * `discoveryFields()` and the HTTP port, as `api_port`. */
+export async function startSimulator(options, answer, discoveryFields) {
+    const requests = [];
+    let stopped = false;
+    let turn = Promise.resolve();
+    const server = createServer((incoming, response) => {
+        let body = "";
+        incoming.setEncoding("utf8");
+        incoming.on("data", (chunk) => {
+            body += chunk;
+        });
+        incoming.on("end", () => {
+            const url = new URL(incoming.url ?? "/", "http://simulator");
+            const request = {
+                method: incoming.method ?? "",
+                path: url.pathname,
+                query: Object.fromEntries(url.searchParams),
+                headers: incoming.headers,
+                body,
+            };
+            requests.push(request);
+            turn = turn.then(async () => {
+                if (options.replyDelayInMs) {
+                    await sleep(options.replyDelayInMs);
+                }
+                if (stopped) {
+                    return;
+                }
+                const reply = answer(request);
+                response.statusCode = reply.statusCode;
+                response.end(reply.body);
+            });
+        });
+    });
+    const address = options.address ?? DEFAULT_ADDRESS;
+    server.listen(0, address);
+    // `once` rejects when the server emits `error` first, as it does for an
+    // address the machine does not have.
+    await once(server, "listening");
+    const { port } = server.address();
+    const stopServer = async () => {
+        // A client keeps its connection open between requests, and `close` alone
+        // waits for it.
+        server.closeAllConnections();
+        server.close();
+        await once(server, "close");
+    };
+    let discoverySockets = [];
+    if (options.answersDiscovery) {
+        try {
+            discoverySockets = await startDiscoverySockets(address, () => formatKeyValue("OK", {
+                ...discoveryFields(),
+                api_port: String(port),
+            }));
+        }
+        catch (error) {
+            await stopServer();
+            throw error;
+        }
+    }
+    return {
+        host: `${address}:${port}`,
+        requests,
+        async stop() {
+            // A server closed a second time never emits `close`.
+            if (stopped) {
+                return;
+            }
+            stopped = true;
+            await Promise.all(discoverySockets.map(closeSocket));
+            await stopServer();
+        },
+    };
+}
+// The probe is a broadcast, which reaches a socket bound to every address and
+// none bound to one. So each simulator hears it on a socket bound to every
+// address, sharing the port with the other simulators, and answers from a
+// second socket bound to its own address: the reply then comes from that
+// address, and a probe sent to that address alone reaches that simulator
+// alone. An adapter answers the address and port the probe came from.
+async function startDiscoverySockets(address, reply) {
+    const own = createSocket({ type: "udp4", reuseAddr: true });
+    const every = createSocket({ type: "udp4", reuseAddr: true });
+    const sockets = [own, every];
+    for (const socket of sockets) {
+        socket.on("message", (message, remote) => {
+            if (message.toString("utf8") === DISCOVERY_PROBE) {
+                // Without a callback, a reply that fails to send is emitted as an
+                // `error` nothing listens for.
+                own.send(reply(), remote.port, remote.address, () => { });
+            }
+        });
+    }
+    try {
+        own.bind(DISCOVERY_PORT, address);
+        // `once` rejects when the socket emits `error` first, as it does for a
+        // port another program holds.
+        await once(own, "listening");
+        every.bind(DISCOVERY_PORT);
+        await once(every, "listening");
+    }
+    catch (error) {
+        await Promise.all(sockets.map(closeSocket));
+        throw error;
+    }
+    return sockets;
+}
+async function closeSocket(socket) {
+    socket.close();
+    await once(socket, "close");
+}
+function sleep(delayInMs) {
+    return new Promise((resolve) => setTimeout(resolve, delayInMs));
+}
+//# sourceMappingURL=simulator.js.map

package/dist/simulators/simulator.js.map

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

package/dist/transport.d.ts

@@ -28,7 +28,8 @@ export interface DaikinTransportOptions {
     host: string;
     /** HTTPS (a Marvell adapter in secure mode). */
     usesHttps?: boolean;
-    /** The terminal uuid, sent as `X-Daikin-uuid` on every call. */
+    /** The terminal uuid, sent as `X-Daikin-uuid` on every call: 32 lowercase
+     * hexadecimal digits, a UUID without its dashes. */
     terminalUuid: string;
     authentication?: DaikinAuthentication;
     /** How long, in milliseconds, to wait for each of the connection, the
@@ -58,7 +59,10 @@ export declare class DaikinTransport {
     private readonly options;
     private readonly origin;
     private readonly client;
-    /** Call `close` when done with the adapter. */
+    private readonly terminalUuidHeaders;
+    /** Call `close` when done with the adapter. It throws an `Error` when
+     * `options.terminalUuid` is not in the form
+     * `DaikinTransportOptions.terminalUuid` describes. */
     constructor(options: DaikinTransportOptions);
     /** Sends one request and returns the reply's body as text. It never retries:
      * wrap the call in `withRetry` for that.

package/dist/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIhE,MAAM,WAAW,oBAAoB;IACnC;6CACyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC;;oEAEgE;IAChE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAID;;wBAEwB;AACxB,wBAAsB,SAAS,CAAC,OAAO,EACrC,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EACjC,EAAE,UAAuC,EAAE,GAAE,kBAAuB,GACnE,OAAO,CAAC,OAAO,CAAC,CAYlB;AAoBD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAC/B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC;;2DAEuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AAED;;wDAEwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B;mFAC+E;IAC/E,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED;;;;;;;gBAOgB;AAChB,qBAAa,eAAe;IAKd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,+CAA+C;IAC/C,YAA6B,OAAO,EAAE,sBAAsB,EAU3D;IAED;;;;;;;2BAOuB;IACjB,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDlD;IAED,2CAA2C;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIhE,MAAM,WAAW,oBAAoB;IACnC;6CACyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC;;oEAEgE;IAChE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAID;;wBAEwB;AACxB,wBAAsB,SAAS,CAAC,OAAO,EACrC,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EACjC,EAAE,UAAuC,EAAE,GAAE,kBAAuB,GACnE,OAAO,CAAC,OAAO,CAAC,CAYlB;AAoBD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAC/B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;wDACoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC;;2DAEuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AAED;;wDAEwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B;mFAC+E;IAC/E,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED;;;;;;;gBAOgB;AAChB,qBAAa,eAAe;IAQd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyB;IAE7D;;0DAEsD;IACtD,YAA6B,OAAO,EAAE,sBAAsB,EAa3D;IAED;;;;;;;2BAOuB;IACjB,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDlD;IAED,2CAA2C;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF"}

package/dist/transport.js

@@ -45,9 +45,14 @@ export class DaikinTransport {
     options;
     origin;
     client;
-    /** Call `close` when done with the adapter. */
+    terminalUuidHeaders;
+    /** Call `close` when done with the adapter. It throws an `Error` when
+     * `options.terminalUuid` is not in the form
+     * `DaikinTransportOptions.terminalUuid` describes. */
     constructor(options) {
         this.options = options;
+        // Before the Client, so a uuid that throws leaves no connection open.
+        this.terminalUuidHeaders = encodeTerminalUuid(options.terminalUuid);
         const scheme = options.usesHttps ? "https" : "http";
         this.origin = `${scheme}://${options.host.replace(/\/+$/, "")}`;
         const timeoutInMs = options.timeoutInMs ?? DEFAULT_TIMEOUT_IN_MS;
@@ -73,7 +78,7 @@ export class DaikinTransport {
             .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
             .join("&");
         const headers = {
-            ...encodeTerminalUuid(this.options.terminalUuid),
+            ...this.terminalUuidHeaders,
             ...((await this.options.authentication?.headers()) ?? {}),
             ...(request.jsonBody !== undefined ? JSON_CONTENT_HEADERS : {}),
         };

package/dist/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAehE,MAAM,0BAA0B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE1D;;wBAEwB;AACxB,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,SAAiC,EACjC,EAAE,UAAU,GAAG,0BAA0B,EAAE,GAAuB,EAAE;IAEpE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,YAAY,qBAAqB,CAAC,EAAE,CAAC;gBAC9C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,EAAE,CAAC;AACrB,CAAC;AAED,SAAS,KAAK,CAAC,SAAiB;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,oBAAoB,GAAG;IAC3B,cAAc,EAAE,kBAAkB;CACnC,CAAC;AAEF,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAErC,4EAA4E;AAC5E,gDAAgD;AAChD,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,cAAc;IACd,YAAY;IACZ,gBAAgB;CACjB,CAAC,CAAC;AAsCH;;;;;;;gBAOgB;AAChB,MAAM,OAAO,eAAe;IAQG,OAAO;IAPnB,MAAM,CAAS;IACf,MAAM,CAAS;IACf,mBAAmB,CAAyB;IAE7D;;0DAEsD;IACtD,YAA6B,OAA+B;uBAA/B,OAAO;QAClC,sEAAsE;QACtE,IAAI,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QACpD,IAAI,CAAC,MAAM,GAAG,GAAG,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QAEhE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,qBAAqB,CAAC;QACjE,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE;YACpC,OAAO,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACpE,cAAc,EAAE,WAAW;YAC3B,WAAW,EAAE,WAAW;SACzB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;2BAOuB;IACvB,KAAK,CAAC,IAAI,CAAC,OAAsB;QAC/B,MAAM,mBAAmB,GACvB,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;QACrD,yEAAyE;QACzE,qCAAqC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,mBAAmB,EAAE,CAAC;aACvE,GAAG,CACF,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACf,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAC5D;aACA,IAAI,CAAC,GAAG,CAAC,CAAC;QAEb,MAAM,OAAO,GAA2B;YACtC,GAAG,IAAI,CAAC,mBAAmB;YAC3B,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC;YACzD,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,CAAC;QAEF,IAAI,UAAkB,CAAC;QACvB,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;gBACzC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI;gBACvD,OAAO;gBACP,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;oBAC5C,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;YACH,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;YACjC,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,qBAAqB,OAAO,CAAC,IAAI,sBAAsB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACvF,IACE,wBAAwB,CAAC,GAAG,CACzB,KAA+B,CAAC,IAAI,IAAI,EAAE,CAC5C,EACD,CAAC;gBACD,MAAM,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAC3C,CAAC;YACD,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,UAAU,GAAG,GAAG,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;YAC1C,2EAA2E;YAC3E,kDAAkD;YAClD,MAAM,IAAI,WAAW,CACnB,qBAAqB,OAAO,CAAC,IAAI,SAAS,EAC1C,UAAU,CACX,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,GAAiC;IAC1D,OAAO,GAAG,EAAE,EAAE,KAAK,SAAS;QAC1B,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,EAAE;QAC/B,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;AAC3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "daikin-local-control",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Unofficial Node.js and TypeScript client for controlling Daikin air conditioners over the local network (LAN), with no cloud. Supports classic (BRP069, BRP072) and DSIOT (BRP084) Wi-Fi adapters.",
   "keywords": [
     "daikin",
@@ -48,7 +48,10 @@
     "DESIGN.md",
     "UNSUPPORTED.md"
   ],
-  "exports": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./simulators": "./dist/simulators/index.js"
+  },
   "devDependencies": {
     "@biomejs/biome": "2.5.15",
     "@tsconfig/node22": "^22.0.6",

package/src/clients/classic.ts

@@ -133,6 +133,14 @@ export class ClassicDaikinClient implements DaikinClient {
     return { state: await this.getState(), sensors: await this.getSensors() };
   }
 
+  /** `set_special_mode`, an endpoint of its own beside `set_control_info`. */
+  async setSpecialMode(mode: SpecialMode, enabled: boolean): Promise<void> {
+    await this.command(
+      CLASSIC_ROUTES.setSpecialMode,
+      encodeClassicSpecialMode(mode, enabled),
+    );
+  }
+
   // --- extended controls ---------------------------------------------------
   // Each write goes to its own endpoint, not `set_control_info`.
 
@@ -171,14 +179,6 @@ export class ClassicDaikinClient implements DaikinClient {
     );
   }
 
-  /** Powerful, econo or streamer (`set_special_mode`). */
-  async setSpecialMode(mode: SpecialMode, enabled: boolean): Promise<void> {
-    await this.command(
-      CLASSIC_ROUTES.setSpecialMode,
-      encodeClassicSpecialMode(mode, enabled),
-    );
-  }
-
   /** Whether the unit can be operated from outside the home network
    * (`basic_info`): `null` when the adapter does not report it. */
   async getOutOfHomeAccess(): Promise<boolean | null> {

package/src/clients/client.ts

@@ -5,6 +5,7 @@ import type {
   DaikinSensors,
   DaikinState,
   DaikinStateAndSensors,
+  SpecialMode,
 } from "../models/state.js";
 
 /** The controls every adapter offers, whatever its wire protocol or
@@ -28,6 +29,11 @@ export interface DaikinClient {
    * `CreateDaikinClientOptions.maxStateAgeForSetStateInMs`. */
   setState(control: DaikinControl): Promise<void>;
 
+  /** Turn powerful, econo or streamer on or off, with a request of its own.
+   * `DaikinCapabilities.specialModes` lists the ones the unit takes in each
+   * mode, and the client sends any other as given. */
+  setSpecialMode(mode: SpecialMode, enabled: boolean): Promise<void>;
+
   /** Read-only temperature / humidity readings. */
   getSensors(): Promise<DaikinSensors>;
 

package/src/clients/dsiot.ts

@@ -3,15 +3,16 @@ import { parseDsiotDeviceInfo } from "../codecs/dsiot/device.js";
 import {
   buildDsiotMultireqGet,
   buildDsiotMultireqUpdate,
-  DSIOT_TARGETS,
   type DsiotUpdate,
   parseDsiotMultireqReply,
 } from "../codecs/dsiot/multireq.js";
 import {
   applyDsiotControl,
+  buildDsiotSpecialModeUpdate,
   parseDsiotSensors,
   parseDsiotState,
 } from "../codecs/dsiot/state.js";
+import { DSIOT_TARGETS } from "../codecs/dsiot/tables.js";
 import type { DaikinCapabilities } from "../models/capabilities.js";
 import type { DaikinDeviceInfo } from "../models/device.js";
 import type {
@@ -19,6 +20,7 @@ import type {
   DaikinSensors,
   DaikinState,
   DaikinStateAndSensors,
+  SpecialMode,
 } from "../models/state.js";
 import {
   type DaikinRequestOptions,
@@ -103,6 +105,11 @@ export class DsiotDaikinClient implements DaikinClient {
     };
   }
 
+  /** One leaf of `dgc_status`, on the outdoor unit for powerful. */
+  async setSpecialMode(mode: SpecialMode, enabled: boolean): Promise<void> {
+    await this.multireq("PUT", buildDsiotSpecialModeUpdate(mode, enabled));
+  }
+
   // --- extended controls ---------------------------------------------------
 
   /** Reboot the adapter (`/config/system/reboot`). */

package/src/codecs/classic/capabilities.ts

@@ -16,16 +16,12 @@ import {
   type TargetHumidity,
   type VerticalPosition,
 } from "../../models/state.js";
+import {
+  CLASSIC_COOLING_ONLY_TYPE,
+  CLASSIC_SPECIAL_MODE_BITS,
+} from "./tables.js";
 
 const CAPABILITY_VERSIONS = ["0", "1", "2", "3"];
-// `en_spmode` sets one bit for each special mode the unit takes. Bit 8 is a
-// mode outside `SpecialMode`. The powerful and econo bits count only at
-// `cpv=3` with a `cpv_minor` other than `00`: see UNSUPPORTED.md.
-const SPECIAL_MODE_BITS: Record<SpecialMode, number> = {
-  powerful: 1,
-  econo: 2,
-  streamer: 4,
-};
 const COOLING_ONLY_MODES: readonly OperatingMode[] = [
   "cool",
   "dehumidify",
@@ -120,7 +116,8 @@ export function parseClassicCapabilities(
 }
 
 // Lists none for a unit that reports no `en_spmode`, and econo in every mode
-// but fan: see UNSUPPORTED.md.
+// but fan. The powerful and econo bits count only at `cpv=3` with a
+// `cpv_minor` other than `00`: see UNSUPPORTED.md.
 function specialModes(
   fields: Record<string, string>,
   cpv: string,
@@ -131,7 +128,7 @@ function specialModes(
     cpv === "3" && (fields.cpv_minor ?? "00") !== "00";
   const taken = SPECIAL_MODES.filter(
     (specialMode) =>
-      (bits & SPECIAL_MODE_BITS[specialMode]) !== 0 &&
+      (bits & CLASSIC_SPECIAL_MODE_BITS[specialMode]) !== 0 &&
       (specialMode === "streamer" || followsPowerfulAndEcono),
   );
   const inMode = (mode: OperatingMode) =>
@@ -155,7 +152,7 @@ function modes(fields: Record<string, string>, cpv: string): OperatingMode[] {
   if (!CAPABILITY_VERSIONS.includes(cpv)) {
     return [];
   }
-  return fields.model_type === "C"
+  return fields.model_type === CLASSIC_COOLING_ONLY_TYPE
     ? OPERATING_MODES.filter((mode) => COOLING_ONLY_MODES.includes(mode))
     : [...OPERATING_MODES];
 }

package/src/codecs/classic/extendedControl.ts

@@ -7,36 +7,20 @@ import type {
 } from "../../models/extendedControl.js";
 import type { SpecialMode } from "../../models/state.js";
 import { decodeClassicText } from "./keyValue.js";
+import {
+  CLASSIC_REMOTE_METHODS,
+  CLASSIC_SPECIAL_MODE_KIND_CODES,
+  CLASSIC_TERMINAL_SCOPE_CODES,
+} from "./tables.js";
 
 // Encodes each control outside `DaikinState` as the query its classic `set_*`
 // endpoint takes, and reads each one back from the reply that reports it.
 
-const TERMINAL_SCOPE_CODES: Record<TerminalScope, string> = {
-  self: "0",
-  others: "1",
-  all: "2",
-};
-
 const DEMAND_MODE_CODES: Record<DemandMode, string> = {
   manual: "0",
   auto: "2",
 };
 
-// `spmode_kind` on the wire, which numbers the modes differently from the
-// `adv` that `parseClassicState` reads.
-const SPECIAL_MODE_KIND_CODES: Record<
-  Exclude<SpecialMode, "streamer">,
-  string
-> = {
-  powerful: "1",
-  econo: "2",
-};
-
-// `method`: the adapter is reached from outside the home network while it
-// polls, and from inside only otherwise.
-const REMOTE_METHOD_POLLING = "polling";
-const REMOTE_METHOD_HOME_ONLY = "home only";
-
 const REMOTE_METHOD_INTERVALS = ["notice_ip_int", "notice_sync_int"];
 
 export function encodeClassicLed(on: boolean): Record<string, string> {
@@ -81,7 +65,10 @@ export function encodeClassicSpecialMode(
 ): Record<string, string> {
   return mode === "streamer"
     ? { en_streamer: flag(enabled) }
-    : { set_spmode: flag(enabled), spmode_kind: SPECIAL_MODE_KIND_CODES[mode] };
+    : {
+        set_spmode: flag(enabled),
+        spmode_kind: CLASSIC_SPECIAL_MODE_KIND_CODES[mode],
+      };
 }
 
 /** Reads out-of-home access from a `basic_info` reply: `null` when it carries
@@ -91,7 +78,7 @@ export function parseClassicOutOfHomeAccess(
 ): boolean | null {
   return fields.method === undefined
     ? null
-    : fields.method === REMOTE_METHOD_POLLING;
+    : fields.method === CLASSIC_REMOTE_METHODS.polling;
 }
 
 /** Turns `current`, the `get_remote_method` reply, and `enabled` into the
@@ -102,7 +89,9 @@ export function applyClassicOutOfHomeAccess(
   enabled: boolean,
 ): Record<string, string> {
   const query: Record<string, string> = {
-    method: enabled ? REMOTE_METHOD_POLLING : REMOTE_METHOD_HOME_ONLY,
+    method: enabled
+      ? CLASSIC_REMOTE_METHODS.polling
+      : CLASSIC_REMOTE_METHODS.homeOnly,
   };
   for (const key of REMOTE_METHOD_INTERVALS) {
     const value = current[key];
@@ -171,7 +160,7 @@ export function encodeClassicTerminalKey(key: string): Record<string, string> {
 export function encodeClassicTerminalScope(
   scope: TerminalScope,
 ): Record<string, string> {
-  return { type: TERMINAL_SCOPE_CODES[scope] };
+  return { type: CLASSIC_TERMINAL_SCOPE_CODES[scope] };
 }
 
 function flag(on: boolean): string {