@openmouse/protocol 0.1.0

package/dist/drivers/steelseries/aerox5-wireless-hid.js

@@ -0,0 +1,234 @@
+import { AEROX5_WIRELESS_POLLING_RATES, AEROX5_WIRELESS_REPORT_ID, STEELSERIES_PRODUCTS, STEELSERIES_VENDOR_ID, steelseriesAerox5WirelessBatteryQuery, steelseriesAerox5WirelessDecodeBattery, steelseriesAerox5WirelessDpiOptions, steelseriesAerox5WirelessEncodeButtonsMapping, steelseriesAerox5WirelessEncodeDefaultLighting, steelseriesAerox5WirelessEncodeDimTimer, steelseriesAerox5WirelessEncodeDpiPresets, steelseriesAerox5WirelessEncodePollingRate, steelseriesAerox5WirelessEncodeRainbowEffect, steelseriesAerox5WirelessEncodeReactiveColor, steelseriesAerox5WirelessEncodeSleepTimer, steelseriesAerox5WirelessEncodeZoneColor, steelseriesAerox5WirelessSaveCommand, } from "@openmouse/protocol/steelseries";
+/** rivalcfg's `command_approve_delay`, shared across every SteelSeries family. */
+const COMMAND_DELAY_MS = 50;
+/** rivalcfg reads input-report replies with a 200 ms timeout; allow slack. */
+const RESPONSE_TIMEOUT_MS = 500;
+/** rivalcfg profile default (`aerox5_wireless_wired.py`: "400, 800, 1200, 2400, 3200"). */
+const DEFAULT_DPI = 400;
+const DEFAULT_POLLING_HZ = 1000;
+/**
+ * SteelSeries Aerox 5 Wireless WebHID control.
+ *
+ * One physical mouse, two transport-dependent product-id groups, one class:
+ * the USB-cabled group (`1038:1854`/`185E`/`1862` — "wired mode" in
+ * rivalcfg's naming) and the 2.4 GHz dongle group (`1038:1852`/`185C`/`1860`).
+ * Both use the exact same command set; only the wireless flag bit
+ * (`applyWirelessFlag` in the protocol module) and, per rivalcfg, a longer
+ * expected readback differ. `this.wireless` is fixed from the granted
+ * device's product id at construction and threaded through every encode
+ * call so a client instance never mixes flagged and unflagged commands.
+ *
+ * DPI presets, polling rate, zone colors, reactive color, sleep/dim timers,
+ * rainbow, default lighting, and buttons are write-only — neither rivalcfg
+ * file for this device defines a getter for any of them. Battery level
+ * **is** readable (`92`/`D2`, 2-byte reply, different response shape from
+ * the Rival 3 Wireless's `AA 01`/3-byte reply — see the protocol module's
+ * doc comment) and `readStatus` uses it as the connectivity probe, same
+ * role the Rival 3 Wireless's battery probe plays.
+ *
+ * The config channel is hidapi interface 3, per both rivalcfg files'
+ * `"endpoint": 3` model entries; its WebHID collection shape has not been
+ * captured yet, so the picker offers every interface and the wrong ones
+ * fail the battery probe loudly.
+ */
+export class SteelSeriesAerox5WirelessHidClient {
+    device;
+    wireless;
+    queue = Promise.resolve();
+    listenerAttached = false;
+    inputWaiters = new Set();
+    lastWritten = {
+        dpi: null,
+        pollingRateHz: null,
+    };
+    onInputReport = (event) => {
+        const payload = new Uint8Array(event.data.buffer.slice(event.data.byteOffset, event.data.byteOffset + event.data.byteLength));
+        for (const finish of [...this.inputWaiters])
+            finish(payload);
+    };
+    constructor(device) {
+        this.device = device;
+        this.wireless = STEELSERIES_PRODUCTS.get(device.productId)?.wireless === true
+            && WIRELESS_MODE_PRODUCT_IDS.has(device.productId);
+    }
+    static isSupported(device) {
+        if (device.vendorId !== STEELSERIES_VENDOR_ID)
+            return false;
+        return STEELSERIES_PRODUCTS.get(device.productId)?.family === "aerox5-wireless";
+    }
+    get pollIntervalMs() { return 30_000; }
+    get supportedPollingRates() { return [...AEROX5_WIRELESS_POLLING_RATES]; }
+    getDpiOptions() { return steelseriesAerox5WirelessDpiOptions(); }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+        if (!this.listenerAttached) {
+            this.device.addEventListener("inputreport", this.onInputReport);
+            this.listenerAttached = true;
+        }
+    }
+    async close() {
+        if (this.listenerAttached) {
+            this.device.removeEventListener("inputreport", this.onInputReport);
+            this.listenerAttached = false;
+        }
+        if (this.device.opened)
+            await this.device.close();
+    }
+    async readStatus() {
+        return await this.run(async () => {
+            await this.open();
+            const battery = await this.probeBattery();
+            const product = STEELSERIES_PRODUCTS.get(this.device.productId);
+            const name = this.device.productName?.trim() || `SteelSeries ${product?.model ?? "Aerox 5 Wireless"}`;
+            return {
+                brand: "SteelSeries",
+                name,
+                ui: {
+                    family: "steelseries-aerox5-wireless",
+                    settingsReady: true,
+                    valuesVerified: false,
+                    hideUnsupportedPollingRates: true,
+                    hideProcessingCard: true,
+                    pollingNote: "The Aerox 5 Wireless cannot report its current DPI or polling rate; values shown are the last written by this app, or assumed defaults.",
+                    defaultDisplayName: "SteelSeries Aerox 5 Wireless",
+                },
+                batteryPercent: battery.level,
+                batteryState: battery.isCharging ? "Charging" : "Discharging",
+                dpi: this.lastWritten.dpi ?? DEFAULT_DPI,
+                pollingRateHz: this.lastWritten.pollingRateHz ?? DEFAULT_POLLING_HZ,
+                supportedPollingRates: this.supportedPollingRates,
+                activeProfile: null,
+                connectionType: this.wireless ? "Wireless" : "Wired",
+                liftOffDistance: null,
+                firmware: [],
+            };
+        });
+    }
+    /**
+     * Replaces the mouse's DPI preset table with a single preset. The device
+     * does not expose a getter for DPI, so the existing presets cannot be read
+     * and preserved — record them in SteelSeries GG before testing.
+     */
+    async setDpi(dpi) {
+        const report = steelseriesAerox5WirelessEncodeDpiPresets([dpi], 0, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox5WirelessSaveCommand(this.wireless));
+            this.lastWritten.dpi = dpi;
+        });
+        return dpi;
+    }
+    async setPollingRate(pollingRateHz) {
+        const report = steelseriesAerox5WirelessEncodePollingRate(pollingRateHz, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox5WirelessSaveCommand(this.wireless));
+            this.lastWritten.pollingRateHz = pollingRateHz;
+        });
+        return pollingRateHz;
+    }
+    async setZoneColor(zone, r, g, b) {
+        const report = steelseriesAerox5WirelessEncodeZoneColor(zone, r, g, b, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox5WirelessSaveCommand(this.wireless));
+        });
+    }
+    async setReactiveColor(color) {
+        const report = steelseriesAerox5WirelessEncodeReactiveColor(color, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox5WirelessSaveCommand(this.wireless));
+        });
+    }
+    async setSleepTimer(minutes) {
+        const report = steelseriesAerox5WirelessEncodeSleepTimer(minutes, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox5WirelessSaveCommand(this.wireless));
+        });
+    }
+    async setDimTimer(seconds) {
+        const report = steelseriesAerox5WirelessEncodeDimTimer(seconds, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox5WirelessSaveCommand(this.wireless));
+        });
+    }
+    async setRainbowEffect() {
+        const report = steelseriesAerox5WirelessEncodeRainbowEffect(this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox5WirelessSaveCommand(this.wireless));
+        });
+    }
+    async setDefaultLighting(mode) {
+        const report = steelseriesAerox5WirelessEncodeDefaultLighting(mode, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox5WirelessSaveCommand(this.wireless));
+        });
+    }
+    async setButtonsMapping(mapping) {
+        const report = steelseriesAerox5WirelessEncodeButtonsMapping(mapping, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox5WirelessSaveCommand(this.wireless));
+        });
+    }
+    /** `92`/`D2` — battery percentage and charging state. Doubles as the connectivity probe. */
+    async probeBattery() {
+        const payload = await this.awaitResponse(steelseriesAerox5WirelessBatteryQuery(this.wireless));
+        if (!payload) {
+            throw new Error("The Aerox 5 Wireless did not answer on this interface. Close SteelSeries GG (and the SteelSeriesEngine service); if it still does not answer, add the device again and choose another entry.");
+        }
+        return steelseriesAerox5WirelessDecodeBattery(payload);
+    }
+    async awaitResponse(query) {
+        const response = new Promise((resolve) => {
+            let timer;
+            const finish = (payload) => {
+                clearTimeout(timer);
+                this.inputWaiters.delete(finish);
+                resolve(payload);
+            };
+            timer = setTimeout(() => finish(null), RESPONSE_TIMEOUT_MS);
+            this.inputWaiters.add(finish);
+        });
+        await this.write(query);
+        return await response;
+    }
+    async write(payload) {
+        await this.device.sendReport(AEROX5_WIRELESS_REPORT_ID, payload.buffer);
+    }
+    delay(milliseconds) {
+        return new Promise((resolve) => setTimeout(resolve, milliseconds));
+    }
+    async run(operation) {
+        const result = this.queue.then(operation, operation);
+        this.queue = result.then(() => undefined, () => undefined);
+        return await result;
+    }
+}
+/** The 2.4 GHz dongle-mode PIDs — distinguishes which transform to apply from `wireless: true` in `devices.ts`. */
+const WIRELESS_MODE_PRODUCT_IDS = new Set([0x1852, 0x185c, 0x1860]);
+//# sourceMappingURL=aerox5-wireless-hid.js.map

package/dist/drivers/steelseries/aerox5-wireless-hid.js.map

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

package/dist/drivers/steelseries/aerox9-wireless-hid.d.ts

@@ -0,0 +1,70 @@
+import type { MouseStatus } from "../mouse-types.js";
+import { type Aerox9WirelessDefaultLighting, type Aerox9WirelessZone } from "@openmouse/protocol/steelseries";
+/**
+ * SteelSeries Aerox 9 Wireless WebHID control.
+ *
+ * One physical mouse, two transport-dependent product-id groups, one class —
+ * same architecture as `./aerox5-wireless-hid.ts`: the USB-cabled group
+ * (`1038:185A`/`1876` — "wired mode" in rivalcfg's naming) and the 2.4 GHz
+ * dongle group (`1038:1858`/`1874`). Both use the exact same command set;
+ * only the wireless flag bit (`applyWirelessFlag` in the protocol module)
+ * and, per rivalcfg, a longer expected readback differ. `this.wireless` is
+ * fixed from the granted device's product id at construction and threaded
+ * through every encode call so a client instance never mixes flagged and
+ * unflagged commands.
+ *
+ * DPI presets, polling rate, zone colors, reactive color, sleep/dim timers,
+ * rainbow, and default lighting are write-only — neither rivalcfg file for
+ * this device defines a getter for any of them, and (see the protocol
+ * module's doc comment) this device's rivalcfg profile defines no
+ * button-mapping command at all, unlike the Aerox 5 Wireless — so no setter
+ * for it exists here either. Battery level **is** readable (`92`/`D2`,
+ * 2-byte reply, same shape as the Aerox 5 Wireless) and `readStatus` uses it
+ * as the connectivity probe, same role it plays for that device.
+ *
+ * The config channel is hidapi interface 3, per both rivalcfg files'
+ * `"endpoint": 3` model entries; its WebHID collection shape has not been
+ * captured yet, so the picker offers every interface and the wrong ones
+ * fail the battery probe loudly.
+ */
+export declare class SteelSeriesAerox9WirelessHidClient {
+    readonly device: HIDDevice;
+    private readonly wireless;
+    private queue;
+    private listenerAttached;
+    private readonly inputWaiters;
+    private lastWritten;
+    private readonly onInputReport;
+    constructor(device: HIDDevice);
+    static isSupported(device: HIDDevice): boolean;
+    get pollIntervalMs(): number;
+    get supportedPollingRates(): number[];
+    getDpiOptions(): number[];
+    open(): Promise<void>;
+    close(): Promise<void>;
+    readStatus(): Promise<MouseStatus>;
+    /**
+     * Replaces the mouse's DPI preset table with a single preset. The device
+     * does not expose a getter for DPI, so the existing presets cannot be read
+     * and preserved — record them in SteelSeries GG before testing.
+     */
+    setDpi(dpi: number): Promise<number>;
+    setPollingRate(pollingRateHz: number): Promise<number>;
+    setZoneColor(zone: Aerox9WirelessZone, r: number, g: number, b: number): Promise<void>;
+    setReactiveColor(color: {
+        r: number;
+        g: number;
+        b: number;
+    } | null): Promise<void>;
+    setSleepTimer(minutes: number): Promise<void>;
+    setDimTimer(seconds: number): Promise<void>;
+    setRainbowEffect(): Promise<void>;
+    setDefaultLighting(mode: Aerox9WirelessDefaultLighting): Promise<void>;
+    /** `92`/`D2` — battery percentage and charging state. Doubles as the connectivity probe. */
+    private probeBattery;
+    private awaitResponse;
+    private write;
+    private delay;
+    private run;
+}
+//# sourceMappingURL=aerox9-wireless-hid.d.ts.map

package/dist/drivers/steelseries/aerox9-wireless-hid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aerox9-wireless-hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/steelseries/aerox9-wireless-hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAkBL,KAAK,6BAA6B,EAClC,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAUzC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,kCAAkC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;IACzE,OAAO,CAAC,WAAW,CAGjB;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAK5B;gBAEU,MAAM,EAAE,SAAS;IAM7B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAK9C,IAAI,cAAc,IAAI,MAAM,CAAmB;IAE/C,IAAI,qBAAqB,IAAI,MAAM,EAAE,CAA+C;IAEpF,aAAa,IAAI,MAAM,EAAE;IAEnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IA+BxC;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYpC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYtD,YAAY,CAAC,IAAI,EAAE,kBAAkB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtF,gBAAgB,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlF,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC,kBAAkB,CAAC,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5E,4FAA4F;YAC9E,YAAY;YAUZ,aAAa;YAeb,KAAK;IAInB,OAAO,CAAC,KAAK;YAIC,GAAG;CAKlB"}

package/dist/drivers/steelseries/aerox9-wireless-hid.js

@@ -0,0 +1,227 @@
+import { AEROX9_WIRELESS_POLLING_RATES, AEROX9_WIRELESS_REPORT_ID, STEELSERIES_PRODUCTS, STEELSERIES_VENDOR_ID, steelseriesAerox9WirelessBatteryQuery, steelseriesAerox9WirelessDecodeBattery, steelseriesAerox9WirelessDpiOptions, steelseriesAerox9WirelessEncodeDefaultLighting, steelseriesAerox9WirelessEncodeDimTimer, steelseriesAerox9WirelessEncodeDpiPresets, steelseriesAerox9WirelessEncodePollingRate, steelseriesAerox9WirelessEncodeRainbowEffect, steelseriesAerox9WirelessEncodeReactiveColor, steelseriesAerox9WirelessEncodeSleepTimer, steelseriesAerox9WirelessEncodeZoneColor, steelseriesAerox9WirelessSaveCommand, } from "@openmouse/protocol/steelseries";
+/** rivalcfg's `command_approve_delay`, shared across every SteelSeries family. */
+const COMMAND_DELAY_MS = 50;
+/** rivalcfg reads input-report replies with a 200 ms timeout; allow slack. */
+const RESPONSE_TIMEOUT_MS = 500;
+/** rivalcfg profile default (`aerox9_wireless_wired.py`: "400, 800, 1200, 2400, 3200"). */
+const DEFAULT_DPI = 400;
+const DEFAULT_POLLING_HZ = 1000;
+/**
+ * SteelSeries Aerox 9 Wireless WebHID control.
+ *
+ * One physical mouse, two transport-dependent product-id groups, one class —
+ * same architecture as `./aerox5-wireless-hid.ts`: the USB-cabled group
+ * (`1038:185A`/`1876` — "wired mode" in rivalcfg's naming) and the 2.4 GHz
+ * dongle group (`1038:1858`/`1874`). Both use the exact same command set;
+ * only the wireless flag bit (`applyWirelessFlag` in the protocol module)
+ * and, per rivalcfg, a longer expected readback differ. `this.wireless` is
+ * fixed from the granted device's product id at construction and threaded
+ * through every encode call so a client instance never mixes flagged and
+ * unflagged commands.
+ *
+ * DPI presets, polling rate, zone colors, reactive color, sleep/dim timers,
+ * rainbow, and default lighting are write-only — neither rivalcfg file for
+ * this device defines a getter for any of them, and (see the protocol
+ * module's doc comment) this device's rivalcfg profile defines no
+ * button-mapping command at all, unlike the Aerox 5 Wireless — so no setter
+ * for it exists here either. Battery level **is** readable (`92`/`D2`,
+ * 2-byte reply, same shape as the Aerox 5 Wireless) and `readStatus` uses it
+ * as the connectivity probe, same role it plays for that device.
+ *
+ * The config channel is hidapi interface 3, per both rivalcfg files'
+ * `"endpoint": 3` model entries; its WebHID collection shape has not been
+ * captured yet, so the picker offers every interface and the wrong ones
+ * fail the battery probe loudly.
+ */
+export class SteelSeriesAerox9WirelessHidClient {
+    device;
+    wireless;
+    queue = Promise.resolve();
+    listenerAttached = false;
+    inputWaiters = new Set();
+    lastWritten = {
+        dpi: null,
+        pollingRateHz: null,
+    };
+    onInputReport = (event) => {
+        const payload = new Uint8Array(event.data.buffer.slice(event.data.byteOffset, event.data.byteOffset + event.data.byteLength));
+        for (const finish of [...this.inputWaiters])
+            finish(payload);
+    };
+    constructor(device) {
+        this.device = device;
+        this.wireless = STEELSERIES_PRODUCTS.get(device.productId)?.wireless === true
+            && WIRELESS_MODE_PRODUCT_IDS.has(device.productId);
+    }
+    static isSupported(device) {
+        if (device.vendorId !== STEELSERIES_VENDOR_ID)
+            return false;
+        return STEELSERIES_PRODUCTS.get(device.productId)?.family === "aerox9-wireless";
+    }
+    get pollIntervalMs() { return 30_000; }
+    get supportedPollingRates() { return [...AEROX9_WIRELESS_POLLING_RATES]; }
+    getDpiOptions() { return steelseriesAerox9WirelessDpiOptions(); }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+        if (!this.listenerAttached) {
+            this.device.addEventListener("inputreport", this.onInputReport);
+            this.listenerAttached = true;
+        }
+    }
+    async close() {
+        if (this.listenerAttached) {
+            this.device.removeEventListener("inputreport", this.onInputReport);
+            this.listenerAttached = false;
+        }
+        if (this.device.opened)
+            await this.device.close();
+    }
+    async readStatus() {
+        return await this.run(async () => {
+            await this.open();
+            const battery = await this.probeBattery();
+            const product = STEELSERIES_PRODUCTS.get(this.device.productId);
+            const name = this.device.productName?.trim() || `SteelSeries ${product?.model ?? "Aerox 9 Wireless"}`;
+            return {
+                brand: "SteelSeries",
+                name,
+                ui: {
+                    family: "steelseries-aerox9-wireless",
+                    settingsReady: true,
+                    valuesVerified: false,
+                    hideUnsupportedPollingRates: true,
+                    hideProcessingCard: true,
+                    pollingNote: "The Aerox 9 Wireless cannot report its current DPI or polling rate; values shown are the last written by this app, or assumed defaults.",
+                    defaultDisplayName: "SteelSeries Aerox 9 Wireless",
+                },
+                batteryPercent: battery.level,
+                batteryState: battery.isCharging ? "Charging" : "Discharging",
+                dpi: this.lastWritten.dpi ?? DEFAULT_DPI,
+                pollingRateHz: this.lastWritten.pollingRateHz ?? DEFAULT_POLLING_HZ,
+                supportedPollingRates: this.supportedPollingRates,
+                activeProfile: null,
+                connectionType: this.wireless ? "Wireless" : "Wired",
+                liftOffDistance: null,
+                firmware: [],
+            };
+        });
+    }
+    /**
+     * Replaces the mouse's DPI preset table with a single preset. The device
+     * does not expose a getter for DPI, so the existing presets cannot be read
+     * and preserved — record them in SteelSeries GG before testing.
+     */
+    async setDpi(dpi) {
+        const report = steelseriesAerox9WirelessEncodeDpiPresets([dpi], 0, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox9WirelessSaveCommand(this.wireless));
+            this.lastWritten.dpi = dpi;
+        });
+        return dpi;
+    }
+    async setPollingRate(pollingRateHz) {
+        const report = steelseriesAerox9WirelessEncodePollingRate(pollingRateHz, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox9WirelessSaveCommand(this.wireless));
+            this.lastWritten.pollingRateHz = pollingRateHz;
+        });
+        return pollingRateHz;
+    }
+    async setZoneColor(zone, r, g, b) {
+        const report = steelseriesAerox9WirelessEncodeZoneColor(zone, r, g, b, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox9WirelessSaveCommand(this.wireless));
+        });
+    }
+    async setReactiveColor(color) {
+        const report = steelseriesAerox9WirelessEncodeReactiveColor(color, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox9WirelessSaveCommand(this.wireless));
+        });
+    }
+    async setSleepTimer(minutes) {
+        const report = steelseriesAerox9WirelessEncodeSleepTimer(minutes, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox9WirelessSaveCommand(this.wireless));
+        });
+    }
+    async setDimTimer(seconds) {
+        const report = steelseriesAerox9WirelessEncodeDimTimer(seconds, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox9WirelessSaveCommand(this.wireless));
+        });
+    }
+    async setRainbowEffect() {
+        const report = steelseriesAerox9WirelessEncodeRainbowEffect(this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox9WirelessSaveCommand(this.wireless));
+        });
+    }
+    async setDefaultLighting(mode) {
+        const report = steelseriesAerox9WirelessEncodeDefaultLighting(mode, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesAerox9WirelessSaveCommand(this.wireless));
+        });
+    }
+    /** `92`/`D2` — battery percentage and charging state. Doubles as the connectivity probe. */
+    async probeBattery() {
+        const payload = await this.awaitResponse(steelseriesAerox9WirelessBatteryQuery(this.wireless));
+        if (!payload) {
+            throw new Error("The Aerox 9 Wireless did not answer on this interface. Close SteelSeries GG (and the SteelSeriesEngine service); if it still does not answer, add the device again and choose another entry.");
+        }
+        return steelseriesAerox9WirelessDecodeBattery(payload);
+    }
+    async awaitResponse(query) {
+        const response = new Promise((resolve) => {
+            let timer;
+            const finish = (payload) => {
+                clearTimeout(timer);
+                this.inputWaiters.delete(finish);
+                resolve(payload);
+            };
+            timer = setTimeout(() => finish(null), RESPONSE_TIMEOUT_MS);
+            this.inputWaiters.add(finish);
+        });
+        await this.write(query);
+        return await response;
+    }
+    async write(payload) {
+        await this.device.sendReport(AEROX9_WIRELESS_REPORT_ID, payload.buffer);
+    }
+    delay(milliseconds) {
+        return new Promise((resolve) => setTimeout(resolve, milliseconds));
+    }
+    async run(operation) {
+        const result = this.queue.then(operation, operation);
+        this.queue = result.then(() => undefined, () => undefined);
+        return await result;
+    }
+}
+/** The 2.4 GHz dongle-mode PIDs — distinguishes which transform to apply from `wireless: true` in `devices.ts`. */
+const WIRELESS_MODE_PRODUCT_IDS = new Set([0x1858, 0x1874]);
+//# sourceMappingURL=aerox9-wireless-hid.js.map

package/dist/drivers/steelseries/aerox9-wireless-hid.js.map

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

package/dist/drivers/steelseries/hid.d.ts

@@ -0,0 +1,48 @@
+import type { MouseStatus } from "../mouse-types.js";
+/**
+ * SteelSeries Rival 3 Gen 1 WebHID control (`1038:1824`, `1038:184C`).
+ *
+ * The device is write-only: settings are sent as unnumbered output reports and
+ * nothing can be read back except the two-byte firmware version, which this
+ * driver uses as its connectivity probe. `readStatus` therefore reports the
+ * session's last-written values (or rivalcfg's documented defaults before any
+ * write) with `valuesVerified: false` — it never pretends to have read them.
+ * Every setter follows its write with the save command so the change persists
+ * in the mouse's onboard memory, mirroring rivalcfg's CLI default.
+ *
+ * The config channel is hidapi interface 3; its WebHID collection shape has
+ * not been captured yet, so the picker offers every interface and the wrong
+ * ones fail the firmware probe loudly.
+ */
+export declare class SteelSeriesRival3HidClient {
+    readonly device: HIDDevice;
+    private queue;
+    private listenerAttached;
+    private readonly inputWaiters;
+    private lastWritten;
+    private readonly onInputReport;
+    constructor(device: HIDDevice);
+    static isSupported(device: HIDDevice): boolean;
+    get pollIntervalMs(): number;
+    get supportedPollingRates(): number[];
+    getDpiOptions(): number[];
+    open(): Promise<void>;
+    close(): Promise<void>;
+    readStatus(): Promise<MouseStatus>;
+    /**
+     * Replaces the mouse's DPI preset table with a single preset. The device is
+     * write-only, so the existing presets cannot be read and preserved — record
+     * them in SteelSeries GG before testing, per docs/steelseries-testing.md.
+     */
+    setDpi(dpi: number): Promise<number>;
+    setPollingRate(pollingRateHz: number): Promise<number>;
+    /**
+     * The `10 00` firmware query is the device's only readable value, so it
+     * doubles as the proof that the granted interface is the config channel.
+     */
+    private probeFirmware;
+    private write;
+    private delay;
+    private run;
+}
+//# sourceMappingURL=hid.d.ts.map

package/dist/drivers/steelseries/hid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/steelseries/hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAwBrD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,0BAA0B;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;IACzE,OAAO,CAAC,WAAW,CAGjB;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAK5B;gBAEU,MAAM,EAAE,SAAS;IAI7B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAK9C,IAAI,cAAc,IAAI,MAAM,CAAmB;IAE/C,IAAI,qBAAqB,IAAI,MAAM,EAAE,CAAsC;IAE3E,aAAa,IAAI,MAAM,EAAE;IAEnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IA+BxC;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYpC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY5D;;;OAGG;YACW,aAAa;YAqBb,KAAK;IAInB,OAAO,CAAC,KAAK;YAIC,GAAG;CAKlB"}