@openmouse/protocol 0.1.0

package/dist/drivers/steelseries/hid.js

@@ -0,0 +1,157 @@
+import { RIVAL3_POLLING_RATES, STEELSERIES_PRODUCTS, STEELSERIES_REPORT_ID, STEELSERIES_VENDOR_ID, steelseriesRival3DecodeFirmware, steelseriesRival3DpiOptions, steelseriesRival3EncodeDpiPresets, steelseriesRival3EncodePollingRate, steelseriesRival3FirmwareQuery, steelseriesRival3SaveCommand, } from "@openmouse/protocol/steelseries";
+/** rivalcfg sleeps 50 ms after every command (`command_approve_delay`) and
+ * cites a SteelSeries mouse crashing when driven faster. */
+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, shown only until this session writes a value. */
+const DEFAULT_DPI = 800;
+const DEFAULT_POLLING_HZ = 1000;
+/**
+ * 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 class SteelSeriesRival3HidClient {
+    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 === "rival3";
+    }
+    get pollIntervalMs() { return 30_000; }
+    get supportedPollingRates() { return [...RIVAL3_POLLING_RATES]; }
+    getDpiOptions() { return steelseriesRival3DpiOptions(); }
+    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 3"}`;
+            return {
+                brand: "SteelSeries",
+                name,
+                ui: {
+                    family: "steelseries-rival3",
+                    settingsReady: true,
+                    valuesVerified: false,
+                    hideUnsupportedPollingRates: true,
+                    hideProcessingCard: true,
+                    pollingNote: "The Rival 3 cannot report its current settings; values shown are the last written by this app, or assumed defaults.",
+                    defaultDisplayName: "SteelSeries Rival 3",
+                },
+                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],
+            };
+        });
+    }
+    /**
+     * 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.
+     */
+    async setDpi(dpi) {
+        const report = steelseriesRival3EncodeDpiPresets([dpi], 0);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesRival3SaveCommand());
+            this.lastWritten.dpi = dpi;
+        });
+        return dpi;
+    }
+    async setPollingRate(pollingRateHz) {
+        const report = steelseriesRival3EncodePollingRate(pollingRateHz);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesRival3SaveCommand());
+            this.lastWritten.pollingRateHz = pollingRateHz;
+        });
+        return pollingRateHz;
+    }
+    /**
+     * 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.
+     */
+    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(steelseriesRival3FirmwareQuery());
+        const payload = await response;
+        if (!payload) {
+            throw new Error("The Rival 3 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 steelseriesRival3DecodeFirmware(payload);
+    }
+    async write(payload) {
+        await this.device.sendReport(STEELSERIES_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=hid.js.map

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

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

package/dist/drivers/steelseries/prime-mini-wireless-hid.d.ts

@@ -0,0 +1,62 @@
+import type { MouseStatus } from "../mouse-types.js";
+import { type PrimeMiniWirelessButtonAction, type PrimeMiniWirelessButtonName, type PrimeMiniWirelessDefaultLighting } from "@openmouse/protocol/steelseries";
+/**
+ * SteelSeries Prime Mini Wireless WebHID control.
+ *
+ * One physical mouse, two transport-dependent product-id groups, one class:
+ * the USB-cabled PID (`1038:184A` — "wired mode" in rivalcfg's naming) and
+ * the 2.4 GHz dongle PID (`1038:1848`). Both use the exact same command set;
+ * only the wireless flag bit (`applyPrimeMiniWirelessFlag` 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, LED color, sleep/dim timers, default lighting,
+ * and buttons are write-only — rivalcfg defines no getter for any of them.
+ * Battery level **is** readable (`92`/`D2`, 2-byte reply, same shape as
+ * `./aerox5-wireless-hid.ts`, different 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.
+ *
+ * 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 SteelSeriesPrimeMiniWirelessHidClient {
+    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>;
+    setColor(r: number, g: number, b: number): Promise<void>;
+    setSleepTimer(minutes: number): Promise<void>;
+    setDimTimer(seconds: number): Promise<void>;
+    setDefaultLighting(mode: PrimeMiniWirelessDefaultLighting): Promise<void>;
+    setButtonsMapping(mapping: Partial<Record<PrimeMiniWirelessButtonName, PrimeMiniWirelessButtonAction>>): 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=prime-mini-wireless-hid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prime-mini-wireless-hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/steelseries/prime-mini-wireless-hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAiBL,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACtC,MAAM,iCAAiC,CAAC;AAUzC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,qCAAqC;IAChD,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,CAAmD;IAExF,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,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C,kBAAkB,CAAC,IAAI,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzE,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,2BAA2B,EAAE,6BAA6B,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5H,4FAA4F;YAC9E,YAAY;YAUZ,aAAa;YAeb,KAAK;IAInB,OAAO,CAAC,KAAK;YAIC,GAAG;CAKlB"}

package/dist/drivers/steelseries/prime-mini-wireless-hid.js

@@ -0,0 +1,215 @@
+import { PRIME_MINI_WIRELESS_POLLING_RATES, PRIME_MINI_WIRELESS_REPORT_ID, STEELSERIES_PRODUCTS, STEELSERIES_VENDOR_ID, steelseriesPrimeMiniWirelessBatteryQuery, steelseriesPrimeMiniWirelessDecodeBattery, steelseriesPrimeMiniWirelessDpiOptions, steelseriesPrimeMiniWirelessEncodeButtonsMapping, steelseriesPrimeMiniWirelessEncodeColor, steelseriesPrimeMiniWirelessEncodeDefaultLighting, steelseriesPrimeMiniWirelessEncodeDimTimer, steelseriesPrimeMiniWirelessEncodeDpiPresets, steelseriesPrimeMiniWirelessEncodePollingRate, steelseriesPrimeMiniWirelessEncodeSleepTimer, steelseriesPrimeMiniWirelessSaveCommand, } 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 (`prime_wireless_wired.py`: "400, 800, 1200, 2400, 3200"). */
+const DEFAULT_DPI = 400;
+const DEFAULT_POLLING_HZ = 1000;
+/**
+ * SteelSeries Prime Mini Wireless WebHID control.
+ *
+ * One physical mouse, two transport-dependent product-id groups, one class:
+ * the USB-cabled PID (`1038:184A` — "wired mode" in rivalcfg's naming) and
+ * the 2.4 GHz dongle PID (`1038:1848`). Both use the exact same command set;
+ * only the wireless flag bit (`applyPrimeMiniWirelessFlag` 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, LED color, sleep/dim timers, default lighting,
+ * and buttons are write-only — rivalcfg defines no getter for any of them.
+ * Battery level **is** readable (`92`/`D2`, 2-byte reply, same shape as
+ * `./aerox5-wireless-hid.ts`, different 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.
+ *
+ * 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 SteelSeriesPrimeMiniWirelessHidClient {
+    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 === "prime-mini-wireless";
+    }
+    get pollIntervalMs() { return 30_000; }
+    get supportedPollingRates() { return [...PRIME_MINI_WIRELESS_POLLING_RATES]; }
+    getDpiOptions() { return steelseriesPrimeMiniWirelessDpiOptions(); }
+    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 ?? "Prime Mini Wireless"}`;
+            return {
+                brand: "SteelSeries",
+                name,
+                ui: {
+                    family: "steelseries-prime-mini-wireless",
+                    settingsReady: true,
+                    valuesVerified: false,
+                    hideUnsupportedPollingRates: true,
+                    hideProcessingCard: true,
+                    pollingNote: "The Prime Mini Wireless cannot report its current DPI or polling rate; values shown are the last written by this app, or assumed defaults.",
+                    defaultDisplayName: "SteelSeries Prime Mini 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 = steelseriesPrimeMiniWirelessEncodeDpiPresets([dpi], 0, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesPrimeMiniWirelessSaveCommand(this.wireless));
+            this.lastWritten.dpi = dpi;
+        });
+        return dpi;
+    }
+    async setPollingRate(pollingRateHz) {
+        const report = steelseriesPrimeMiniWirelessEncodePollingRate(pollingRateHz, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesPrimeMiniWirelessSaveCommand(this.wireless));
+            this.lastWritten.pollingRateHz = pollingRateHz;
+        });
+        return pollingRateHz;
+    }
+    async setColor(r, g, b) {
+        const report = steelseriesPrimeMiniWirelessEncodeColor(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(steelseriesPrimeMiniWirelessSaveCommand(this.wireless));
+        });
+    }
+    async setSleepTimer(minutes) {
+        const report = steelseriesPrimeMiniWirelessEncodeSleepTimer(minutes, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesPrimeMiniWirelessSaveCommand(this.wireless));
+        });
+    }
+    async setDimTimer(seconds) {
+        const report = steelseriesPrimeMiniWirelessEncodeDimTimer(seconds, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesPrimeMiniWirelessSaveCommand(this.wireless));
+        });
+    }
+    async setDefaultLighting(mode) {
+        const report = steelseriesPrimeMiniWirelessEncodeDefaultLighting(mode, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesPrimeMiniWirelessSaveCommand(this.wireless));
+        });
+    }
+    async setButtonsMapping(mapping) {
+        const report = steelseriesPrimeMiniWirelessEncodeButtonsMapping(mapping, this.wireless);
+        await this.run(async () => {
+            await this.open();
+            await this.write(report);
+            await this.delay(COMMAND_DELAY_MS);
+            await this.write(steelseriesPrimeMiniWirelessSaveCommand(this.wireless));
+        });
+    }
+    /** `92`/`D2` — battery percentage and charging state. Doubles as the connectivity probe. */
+    async probeBattery() {
+        const payload = await this.awaitResponse(steelseriesPrimeMiniWirelessBatteryQuery(this.wireless));
+        if (!payload) {
+            throw new Error("The Prime Mini 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 steelseriesPrimeMiniWirelessDecodeBattery(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(PRIME_MINI_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 PID — distinguishes which transform to apply from `wireless: true` in `devices.ts`. */
+const WIRELESS_MODE_PRODUCT_IDS = new Set([0x1848]);
+//# sourceMappingURL=prime-mini-wireless-hid.js.map

package/dist/drivers/steelseries/prime-mini-wireless-hid.js.map

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

package/dist/drivers/steelseries/prime-plus-hid.d.ts

@@ -0,0 +1,51 @@
+import type { MouseStatus } from "../mouse-types.js";
+import { type PrimePlusButtonAction, type PrimePlusButtonName } from "@openmouse/protocol/steelseries";
+/**
+ * SteelSeries Prime+ WebHID control (`1038:182C`).
+ *
+ * Like Aerox 3, the Prime+ has **no readable value at all** — no firmware
+ * query exists in `prime_plus.py`, so there is nothing to probe the device
+ * with. `readStatus` therefore treats a successful `open()` as the only
+ * available connectivity signal and reports the session's last-written
+ * values (or rivalcfg's documented defaults before any write) with
+ * `valuesVerified: false`, same honesty policy as Aerox 3 and Rival 3 Gen 1.
+ * 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 0, per `prime_plus.py`'s
+ * `"endpoint": 0` model entry; its WebHID collection shape has not been
+ * captured yet, so the picker offers every interface.
+ *
+ * See `../../steelseries/prime-plus.ts`'s doc comment for the full
+ * corroboration-gap disclosure (rivalcfg only — libratbag has no Prime/
+ * Prime+ support and OpenRGB's SteelSeries controller sources could not be
+ * located from this environment) and for why this device's protocol is not
+ * distinguishable from plain Prime's despite being its own module here.
+ */
+export declare class SteelSeriesPrimePlusHidClient {
+    readonly device: HIDDevice;
+    private queue;
+    private lastWritten;
+    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>;
+    setColor(r: number, g: number, b: number): Promise<void>;
+    setLedBrightness(level: number): Promise<void>;
+    setButtonsMapping(mapping: Partial<Record<PrimePlusButtonName, PrimePlusButtonAction>>): Promise<void>;
+    private write;
+    private delay;
+    private run;
+}
+//# sourceMappingURL=prime-plus-hid.d.ts.map

package/dist/drivers/steelseries/prime-plus-hid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prime-plus-hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/steelseries/prime-plus-hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAYL,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AAQzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,6BAA6B;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,WAAW,CAGjB;gBAEU,MAAM,EAAE,SAAS;IAI7B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAM9C,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;IAIrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IA6BxC;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYpC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYtD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9C,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;YAU9F,KAAK;IAInB,OAAO,CAAC,KAAK;YAIC,GAAG;CAKlB"}