@openmouse/protocol 0.1.0

package/dist/drivers/steelseries/rival310-hid.js

@@ -0,0 +1,182 @@
+import { RIVAL310_POLLING_RATES, STEELSERIES_PRODUCTS, STEELSERIES_RIVAL310_REPORT_ID, STEELSERIES_VENDOR_ID, steelseriesRival310DecodeFirmware, steelseriesRival310DpiOptions, steelseriesRival310EncodeButtonsMapping, steelseriesRival310EncodeLedColor, steelseriesRival310EncodePollingRate, steelseriesRival310EncodeSensitivity1, steelseriesRival310FirmwareQuery, steelseriesRival310SaveCommand, } from "@openmouse/protocol/steelseries";
+/** rivalcfg's `command_approve_delay`, shared across every SteelSeries family. */
+const COMMAND_DELAY_MS = 50;
+/** rivalcfg reads the firmware response with a 200 ms timeout; allow slack. */
+const FIRMWARE_TIMEOUT_MS = 500;
+/** rivalcfg profile defaults (`rival310.py`), shown only until this session writes a value. */
+const DEFAULT_DPI = 800;
+const DEFAULT_POLLING_HZ = 1000;
+/**
+ * SteelSeries Rival 310 WebHID control (`1038:1720`, `1038:171E` CS:GO Howl
+ * Edition, `1038:1736` PUBG Edition — one shared command set, see
+ * `../../steelseries/rival310.ts`'s doc comment).
+ *
+ * The device is write-only for settings: only the two-byte firmware version
+ * (`90 00`) can be read back, and this driver uses it as its connectivity
+ * probe, same pattern as `./hid.ts`'s Rival 3 Gen 1 client. `readStatus`
+ * therefore reports the session's last-written DPI/polling values (or
+ * rivalcfg's documented defaults before any write) with
+ * `valuesVerified: false` — it never pretends to have read them from the
+ * mouse. 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 `endpoint 0`, per `rival310.py`'s model
+ * entries; its WebHID collection shape has not been captured yet, so the
+ * picker offers every interface and the wrong ones fail the firmware probe
+ * loudly, same as Rival 3 Gen 1.
+ *
+ * LED color writes are HID **feature** reports, not output reports (see
+ * `steelseriesRival310EncodeLedColor`'s doc comment) — `setLedColor` routes
+ * through `device.sendFeatureReport`, unlike every other setter here.
+ */
+export class SteelSeriesRival310HidClient {
+    device;
+    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;
+    }
+    static isSupported(device) {
+        if (device.vendorId !== STEELSERIES_VENDOR_ID)
+            return false;
+        return STEELSERIES_PRODUCTS.get(device.productId)?.family === "rival310";
+    }
+    get pollIntervalMs() { return 30_000; }
+    get supportedPollingRates() { return [...RIVAL310_POLLING_RATES]; }
+    getDpiOptions() { return steelseriesRival310DpiOptions(); }
+    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 firmware = await this.probeFirmware();
+            const product = STEELSERIES_PRODUCTS.get(this.device.productId);
+            const name = this.device.productName?.trim() || `SteelSeries ${product?.model ?? "Rival 310"}`;
+            return {
+                brand: "SteelSeries",
+                name,
+                ui: {
+                    family: "steelseries-rival310",
+                    settingsReady: true,
+                    valuesVerified: false,
+                    hideUnsupportedPollingRates: true,
+                    hideProcessingCard: true,
+                    pollingNote: "The Rival 310 cannot report its current settings; values shown are the last written by this app, or assumed defaults.",
+                    defaultDisplayName: "SteelSeries Rival 310",
+                },
+                batteryPercent: null,
+                batteryState: "Unknown",
+                dpi: this.lastWritten.dpi ?? DEFAULT_DPI,
+                pollingRateHz: this.lastWritten.pollingRateHz ?? DEFAULT_POLLING_HZ,
+                supportedPollingRates: this.supportedPollingRates,
+                activeProfile: null,
+                connectionType: "Wired",
+                liftOffDistance: null,
+                firmware: [firmware.display],
+            };
+        });
+    }
+    /**
+     * Writes sensitivity preset 1 only. The device is write-only, so the
+     * existing preset 2 and button/lighting configuration cannot be read and
+     * preserved — record them before testing, per docs/steelseries-testing.md.
+     */
+    async setDpi(dpi) {
+        const report = steelseriesRival310EncodeSensitivity1(dpi);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesRival310SaveCommand());
+            this.lastWritten.dpi = dpi;
+        });
+        return dpi;
+    }
+    async setPollingRate(pollingRateHz) {
+        const report = steelseriesRival310EncodePollingRate(pollingRateHz);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesRival310SaveCommand());
+            this.lastWritten.pollingRateHz = pollingRateHz;
+        });
+        return pollingRateHz;
+    }
+    async setLedColor(led, r, g, b) {
+        const report = steelseriesRival310EncodeLedColor(led, r, g, b);
+        await this.run(async () => {
+            await this.open();
+            await this.device.sendFeatureReport(STEELSERIES_RIVAL310_REPORT_ID, report.buffer);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesRival310SaveCommand());
+        });
+    }
+    async setButtonsMapping(mapping) {
+        const report = steelseriesRival310EncodeButtonsMapping(mapping);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesRival310SaveCommand());
+        });
+    }
+    /**
+     * The `90 00` firmware query is the device's only readable value, so it
+     * doubles as the proof that the granted interface is the config channel.
+     */
+    async probeFirmware() {
+        const response = new Promise((resolve) => {
+            let timer;
+            const finish = (payload) => {
+                clearTimeout(timer);
+                this.inputWaiters.delete(finish);
+                resolve(payload);
+            };
+            timer = setTimeout(() => finish(null), FIRMWARE_TIMEOUT_MS);
+            this.inputWaiters.add(finish);
+        });
+        await this.write(steelseriesRival310FirmwareQuery());
+        const payload = await response;
+        if (!payload) {
+            throw new Error("The Rival 310 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 steelseriesRival310DecodeFirmware(payload);
+    }
+    async write(payload) {
+        await this.device.sendReport(STEELSERIES_RIVAL310_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;
+    }
+}
+//# sourceMappingURL=rival310-hid.js.map

package/dist/drivers/steelseries/rival310-hid.js.map

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

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

@@ -0,0 +1,68 @@
+import type { MouseStatus } from "../mouse-types.js";
+import { type Rival650ButtonAction, type Rival650ButtonName } from "@openmouse/protocol/steelseries";
+/**
+ * SteelSeries Rival 650 Wireless WebHID control (`1038:172B` wired mode,
+ * `1038:1726` 2.4 GHz wireless mode).
+ *
+ * DPI (two independent presets, `sensitivity1`/`sensitivity2` — this codec
+ * exposes `setDpi` against preset 1 only, matching every other SteelSeries
+ * family's single-`setDpi` surface), polling rate, lift-off distance,
+ * buttons, and the sleep timer are all write-only — `rival650.py` defines no
+ * getter for any of them. Unlike `SteelSeriesRival3WirelessHidClient`, this
+ * device has **no firmware-query command** at all (`rival650.py` defines no
+ * `firmware_version` block), so `readStatus` reports firmware as unknown
+ * rather than probing for it. `battery_level` (`AA 01`) is readable and
+ * doubles as this client's connectivity probe, same role it plays for the
+ * Rival 3 Wireless. `readStatus` therefore has `valuesVerified: false`:
+ * DPI, polling rate, and lift-off distance are the session's last-written
+ * values (or rivalcfg's documented defaults before any write).
+ *
+ * The config channel is hidapi interface 0, per `rival650.py`'s
+ * `"endpoint": 0` model entries (both PIDs); 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 SteelSeriesRival650HidClient {
+    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>;
+    /** `15 01 <v>` — sensitivity preset 1. The device has no getter, so preset 2 is left untouched by this call. */
+    setDpi(dpi: number): Promise<number>;
+    setPollingRate(pollingRateHz: number): Promise<number>;
+    /**
+     * `20 01 <v>` — lift-off distance, 1–8 mm. Named distinctly from the
+     * shared `setLiftOffDistance(lod: "Low" | "Medium" | "High")` surface
+     * every other driver implements: the Rival 650's scale is a raw
+     * millimeter range with no natural 3-way mapping onto that enum (see the
+     * `readStatus` comment above), and giving it the same method name would
+     * collapse `SupportedClient`'s intersected parameter type to `never` for
+     * every driver, since TypeScript intersects the parameter types of a
+     * union of function members. Not currently wired to any UI control.
+     */
+    setLiftOffDistanceMm(millimeters: number): Promise<number>;
+    /** `2B 01 01 00 00 00 <v>` — idle minutes before sleep, 1–20. */
+    setSleepTimer(minutes: number): Promise<void>;
+    setButtonsMapping(mapping: Partial<Record<Rival650ButtonName, Rival650ButtonAction>>): Promise<void>;
+    /**
+     * `AA 01` — battery percentage and charging state. Doubles as the proof
+     * that the granted interface is the config channel, same role it plays
+     * for `SteelSeriesRival3WirelessHidClient`.
+     */
+    private probeBattery;
+    private awaitResponse;
+    private write;
+    private delay;
+    private run;
+}
+//# sourceMappingURL=rival650-hid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rival650-hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/steelseries/rival650-hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAeL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAUzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,4BAA4B;IACvC,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,CAIjB;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,CAAwC;IAE7E,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;IAoCxC,gHAAgH;IAC1G,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYpC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY5D;;;;;;;;;OASG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYhE,iEAAiE;IAC3D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1G;;;;OAIG;YACW,YAAY;YAUZ,aAAa;YAeb,KAAK;IAInB,OAAO,CAAC,KAAK;YAIC,GAAG;CAKlB"}

package/dist/drivers/steelseries/rival650-hid.js

@@ -0,0 +1,209 @@
+import { RIVAL650_POLLING_RATES, STEELSERIES_PRODUCTS, STEELSERIES_VENDOR_ID, RIVAL650_REPORT_ID, steelseriesRival650BatteryQuery, steelseriesRival650DecodeBattery, steelseriesRival650DpiOptions, steelseriesRival650EncodeButtonsMapping, steelseriesRival650EncodeLiftOffDistance, steelseriesRival650EncodePollingRate, steelseriesRival650EncodeSensitivity1, steelseriesRival650EncodeSleepTimer, steelseriesRival650SaveCommand, } 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 (`rival650.py`: `sensitivity1` default 800). */
+const DEFAULT_DPI = 800;
+const DEFAULT_POLLING_HZ = 1000;
+/**
+ * SteelSeries Rival 650 Wireless WebHID control (`1038:172B` wired mode,
+ * `1038:1726` 2.4 GHz wireless mode).
+ *
+ * DPI (two independent presets, `sensitivity1`/`sensitivity2` — this codec
+ * exposes `setDpi` against preset 1 only, matching every other SteelSeries
+ * family's single-`setDpi` surface), polling rate, lift-off distance,
+ * buttons, and the sleep timer are all write-only — `rival650.py` defines no
+ * getter for any of them. Unlike `SteelSeriesRival3WirelessHidClient`, this
+ * device has **no firmware-query command** at all (`rival650.py` defines no
+ * `firmware_version` block), so `readStatus` reports firmware as unknown
+ * rather than probing for it. `battery_level` (`AA 01`) is readable and
+ * doubles as this client's connectivity probe, same role it plays for the
+ * Rival 3 Wireless. `readStatus` therefore has `valuesVerified: false`:
+ * DPI, polling rate, and lift-off distance are the session's last-written
+ * values (or rivalcfg's documented defaults before any write).
+ *
+ * The config channel is hidapi interface 0, per `rival650.py`'s
+ * `"endpoint": 0` model entries (both PIDs); 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 SteelSeriesRival650HidClient {
+    device;
+    queue = Promise.resolve();
+    listenerAttached = false;
+    inputWaiters = new Set();
+    lastWritten = {
+        dpi: null,
+        pollingRateHz: null,
+        liftOffDistance: 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;
+    }
+    static isSupported(device) {
+        if (device.vendorId !== STEELSERIES_VENDOR_ID)
+            return false;
+        return STEELSERIES_PRODUCTS.get(device.productId)?.family === "rival650";
+    }
+    get pollIntervalMs() { return 30_000; }
+    get supportedPollingRates() { return [...RIVAL650_POLLING_RATES]; }
+    getDpiOptions() { return steelseriesRival650DpiOptions(); }
+    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 ?? "Rival 650 Wireless"}`;
+            return {
+                brand: "SteelSeries",
+                name,
+                ui: {
+                    family: "steelseries-rival650",
+                    settingsReady: true,
+                    valuesVerified: false,
+                    hideUnsupportedPollingRates: true,
+                    hideProcessingCard: true,
+                    pollingNote: "The Rival 650 Wireless cannot report its current DPI, polling rate, or lift-off distance; values shown are the last written by this app, or assumed defaults.",
+                    defaultDisplayName: "SteelSeries Rival 650 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: "Wireless",
+                // `MouseStatus.liftOffDistance` is the shared three-stop Low/Medium/
+                // High enum; this device's 1–8 mm scale does not map onto it cleanly
+                // (same reason every sibling SteelSeries client reports null here),
+                // so the raw last-written millimeter value stays internal to this
+                // client (`this.lastWritten.liftOffDistance`) rather than surfaced.
+                liftOffDistance: null,
+                firmware: [],
+            };
+        });
+    }
+    /** `15 01 <v>` — sensitivity preset 1. The device has no getter, so preset 2 is left untouched by this call. */
+    async setDpi(dpi) {
+        const report = steelseriesRival650EncodeSensitivity1(dpi);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesRival650SaveCommand());
+            this.lastWritten.dpi = dpi;
+        });
+        return dpi;
+    }
+    async setPollingRate(pollingRateHz) {
+        const report = steelseriesRival650EncodePollingRate(pollingRateHz);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesRival650SaveCommand());
+            this.lastWritten.pollingRateHz = pollingRateHz;
+        });
+        return pollingRateHz;
+    }
+    /**
+     * `20 01 <v>` — lift-off distance, 1–8 mm. Named distinctly from the
+     * shared `setLiftOffDistance(lod: "Low" | "Medium" | "High")` surface
+     * every other driver implements: the Rival 650's scale is a raw
+     * millimeter range with no natural 3-way mapping onto that enum (see the
+     * `readStatus` comment above), and giving it the same method name would
+     * collapse `SupportedClient`'s intersected parameter type to `never` for
+     * every driver, since TypeScript intersects the parameter types of a
+     * union of function members. Not currently wired to any UI control.
+     */
+    async setLiftOffDistanceMm(millimeters) {
+        const report = steelseriesRival650EncodeLiftOffDistance(millimeters);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesRival650SaveCommand());
+            this.lastWritten.liftOffDistance = millimeters;
+        });
+        return millimeters;
+    }
+    /** `2B 01 01 00 00 00 <v>` — idle minutes before sleep, 1–20. */
+    async setSleepTimer(minutes) {
+        const report = steelseriesRival650EncodeSleepTimer(minutes);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesRival650SaveCommand());
+        });
+    }
+    async setButtonsMapping(mapping) {
+        const report = steelseriesRival650EncodeButtonsMapping(mapping);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesRival650SaveCommand());
+        });
+    }
+    /**
+     * `AA 01` — battery percentage and charging state. Doubles as the proof
+     * that the granted interface is the config channel, same role it plays
+     * for `SteelSeriesRival3WirelessHidClient`.
+     */
+    async probeBattery() {
+        const payload = await this.awaitResponse(steelseriesRival650BatteryQuery());
+        if (!payload) {
+            throw new Error("The Rival 650 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 steelseriesRival650DecodeBattery(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(RIVAL650_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;
+    }
+}
+//# sourceMappingURL=rival650-hid.js.map

package/dist/drivers/steelseries/rival650-hid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rival650-hid.js","sourceRoot":"","sources":["../../../src/drivers/steelseries/rival650-hid.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,+BAA+B,EAC/B,gCAAgC,EAChC,6BAA6B,EAC7B,uCAAuC,EACvC,wCAAwC,EACxC,oCAAoC,EACpC,qCAAqC,EACrC,mCAAmC,EACnC,8BAA8B,GAI/B,MAAM,iCAAiC,CAAC;AAEzC,kFAAkF;AAClF,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,8EAA8E;AAC9E,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,4EAA4E;AAC5E,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,4BAA4B;IAC9B,MAAM,CAAY;IACnB,KAAK,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5C,gBAAgB,GAAG,KAAK,CAAC;IAChB,YAAY,GAAG,IAAI,GAAG,EAAiC,CAAC;IACjE,WAAW,GAAyF;QAC1G,GAAG,EAAE,IAAI;QACT,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;KACtB,CAAC;IAEe,aAAa,GAAG,CAAC,KAA0B,EAAQ,EAAE;QACpE,MAAM,OAAO,GAAG,IAAI,UAAU,CAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAC9F,CAAC;QACF,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC;YAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/D,CAAC,CAAC;IAEF,YAAY,MAAiB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,MAAiB;QAClC,IAAI,MAAM,CAAC,QAAQ,KAAK,qBAAqB;YAAE,OAAO,KAAK,CAAC;QAC5D,OAAO,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC;IAC3E,CAAC;IAED,IAAI,cAAc,KAAa,OAAO,MAAM,CAAC,CAAC,CAAC;IAE/C,IAAI,qBAAqB,KAAe,OAAO,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAE7E,aAAa,KAAe,OAAO,6BAA6B,EAAE,CAAC,CAAC,CAAC;IAErE,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAChE,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YACnE,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAChC,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAChE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,eAAe,OAAO,EAAE,KAAK,IAAI,oBAAoB,EAAE,CAAC;YACxG,OAAO;gBACL,KAAK,EAAE,aAAa;gBACpB,IAAI;gBACJ,EAAE,EAAE;oBACF,MAAM,EAAE,sBAAsB;oBAC9B,aAAa,EAAE,IAAI;oBACnB,cAAc,EAAE,KAAK;oBACrB,2BAA2B,EAAE,IAAI;oBACjC,kBAAkB,EAAE,IAAI;oBACxB,WAAW,EAAE,+JAA+J;oBAC5K,kBAAkB,EAAE,gCAAgC;iBACrD;gBACD,cAAc,EAAE,OAAO,CAAC,KAAK;gBAC7B,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa;gBAC7D,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,WAAW;gBACxC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,aAAa,IAAI,kBAAkB;gBACnE,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;gBACjD,aAAa,EAAE,IAAI;gBACnB,cAAc,EAAE,UAAU;gBAC1B,qEAAqE;gBACrE,qEAAqE;gBACrE,oEAAoE;gBACpE,kEAAkE;gBAClE,oEAAoE;gBACpE,eAAe,EAAE,IAAI;gBACrB,QAAQ,EAAE,EAAE;aACb,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gHAAgH;IAChH,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,MAAM,GAAG,qCAAqC,CAAC,GAAG,CAAC,CAAC;QAC1D,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzB,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,KAAK,CAAC,8BAA8B,EAAE,CAAC,CAAC;YACnD,IAAI,CAAC,WAAW,CAAC,GAAG,GAAG,GAAG,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,aAAqB;QACxC,MAAM,MAAM,GAAG,oCAAoC,CAAC,aAAa,CAAC,CAAC;QACnE,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzB,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,KAAK,CAAC,8BAA8B,EAAE,CAAC,CAAC;YACnD,IAAI,CAAC,WAAW,CAAC,aAAa,GAAG,aAAa,CAAC;QACjD,CAAC,CAAC,CAAC;QACH,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,oBAAoB,CAAC,WAAmB;QAC5C,MAAM,MAAM,GAAG,wCAAwC,CAAC,WAAW,CAAC,CAAC;QACrE,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzB,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,KAAK,CAAC,8BAA8B,EAAE,CAAC,CAAC;YACnD,IAAI,CAAC,WAAW,CAAC,eAAe,GAAG,WAAW,CAAC;QACjD,CAAC,CAAC,CAAC;QACH,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,MAAM,MAAM,GAAG,mCAAmC,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzB,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,KAAK,CAAC,8BAA8B,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,OAAkE;QACxF,MAAM,MAAM,GAAG,uCAAuC,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzB,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,KAAK,CAAC,8BAA8B,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,YAAY;QACxB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,+BAA+B,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,gMAAgM,CACjM,CAAC;QACJ,CAAC;QACD,OAAO,gCAAgC,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,KAAiB;QAC3C,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,EAAE;YAC1D,IAAI,KAAoC,CAAC;YACzC,MAAM,MAAM,GAAG,CAAC,OAA0B,EAAQ,EAAE;gBAClD,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAuC,CAAC,CAAC;gBAClE,OAAO,CAAC,OAAO,CAAC,CAAC;YACnB,CAAC,CAAC;YACF,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC,CAAC;YAC5D,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAuC,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,MAAM,QAAQ,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,OAAmB;QACrC,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,kBAAkB,EAAE,OAAO,CAAC,MAAqB,CAAC,CAAC;IAClF,CAAC;IAEO,KAAK,CAAC,YAAoB;QAChC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IACrE,CAAC;IAEO,KAAK,CAAC,GAAG,CAAI,SAA2B;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3D,OAAO,MAAM,MAAM,CAAC;IACtB,CAAC;CACF"}

package/dist/drivers/steelseries/sensei-ten-hid.d.ts

@@ -0,0 +1,62 @@
+import type { MouseStatus } from "../mouse-types.js";
+import { type SenseiTenButtonAction, type SenseiTenButtonName, type SenseiTenColorStop, type SenseiTenLed } from "@openmouse/protocol/steelseries";
+/**
+ * SteelSeries Sensei TEN WebHID control (`1038:1832`, `1038:1834` CS:GO Neon
+ * Rider Edition).
+ *
+ * The device is write-only for DPI/polling/lighting/buttons: settings are
+ * sent as unnumbered output (or, for `logo_color`/`wheel_color`, feature)
+ * reports and nothing can be read back except the two-byte firmware
+ * version, which this driver uses as its connectivity probe — same pattern
+ * as Rival 3 Gen 1's `10 00`, but Sensei TEN's query is `90 00`.
+ * `readStatus` therefore reports the session's last-written values (or
+ * rivalcfg's documented defaults before any write) with `valuesVerified:
+ * false`. 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 `endpoint: 0`, per `sensei_ten.py`'s model
+ * entries; its WebHID collection shape has not been captured yet, so the
+ * picker offers every interface and the wrong ones fail the firmware probe
+ * loudly.
+ *
+ * See `../../steelseries/sensei-ten.ts`'s doc comment for the full protocol
+ * writeup, including the flagged corroboration gap (rivalcfg only — no
+ * libratbag or OpenRGB source was reachable for this device).
+ */
+export declare class SteelSeriesSenseiTenHidClient {
+    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 before testing.
+     */
+    setDpi(dpi: number): Promise<number>;
+    setPollingRate(pollingRateHz: number): Promise<number>;
+    /** `5B 00` feature report — see `steelseriesSenseiTenEncodeLedColor`'s doc comment. */
+    setLedColor(led: SenseiTenLed, stops: readonly SenseiTenColorStop[], durationMs?: number): Promise<void>;
+    setButtonsMapping(mapping?: Partial<Record<SenseiTenButtonName, SenseiTenButtonAction>>): Promise<void>;
+    /**
+     * The `90 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 writeFeature;
+    private delay;
+    private run;
+}
+//# sourceMappingURL=sensei-ten-hid.d.ts.map

package/dist/drivers/steelseries/sensei-ten-hid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensei-ten-hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/steelseries/sensei-ten-hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAcL,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAEvB,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AAUzC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,6BAA6B;IACxC,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,CAA0C;IAE/E,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;IA8BxC;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYpC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY5D,uFAAuF;IACjF,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,kBAAkB,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxG,iBAAiB,CACrB,OAAO,GAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAAsC,GACxG,OAAO,CAAC,IAAI,CAAC;IAUhB;;;OAGG;YACW,aAAa;YAqBb,KAAK;YAIL,YAAY;IAI1B,OAAO,CAAC,KAAK;YAIC,GAAG;CAKlB"}