@openmouse/protocol 0.1.0

package/dist/drivers/gwolves/hid.js

@@ -0,0 +1,225 @@
+import { GWOLVES_ADDRESS, GWOLVES_COMMAND, GWOLVES_REPORT_ID, gwolvesBuildReadPayload, gwolvesBuildSimplePayload, gwolvesBuildWritePayload, gwolvesBuildWriteScalarPayload, gwolvesDecodeProfile, gwolvesEncodeDpi, gwolvesEncodePollingRate, gwolvesParseBattery, gwolvesParseReadResponse, gwolvesReportChecksumIsValid, } from "@openmouse/protocol/gwolves";
+import { GWOLVES_PRODUCTS, GWOLVES_VENDOR_ID } from "./products.js";
+// G-Wolves mice enumerate under their own vendor id (0x33e4) but speak the
+// exact same shared VGN-family wire protocol already implemented
+// independently in this repo for the VGN Dragonfly F2 Master+ and the
+// Pulsar 4K Wireless Receiver — identical opcodes, checksums, EEPROM
+// address map, DPI encoding, and polling-rate encoding. This driver uses
+// its own protocol module (../../gwolves/index.ts) rather than importing
+// vgn's, matching the pattern already established for the Pulsar/VGN case:
+// independent per-brand implementation of a shared algorithm, so a future
+// G-Wolves-specific quirk can diverge without touching another brand's
+// tested code. Confirmed against real hardware 2026-08-21 via a live HID
+// capture (browser sendReport/inputreport patch) while changing DPI, LOD,
+// and polling rate on the official G-Wolves web driver at mouse.fit, then
+// independently reproduced with hidapitester with no browser involved at
+// all. See PROTOCOL-NOTES.md in the PR for the raw captured packets this
+// was verified against.
+//
+// This class is intentionally model-agnostic: per-product identity (name,
+// wireless/wired, verified-on-hardware status) lives in ./products.ts, not
+// here. Adding support for another G-Wolves model that turns out to share
+// this same protocol should just mean a new entry in that catalog.
+const RESPONSE_TIMEOUT_MS = 700;
+const SUPPORTED_POLLING_RATES = [125, 250, 500, 1000, 2000, 4000, 8000];
+export class GWolvesHidClient {
+    device;
+    waiter = null;
+    onInputReport = (event) => {
+        if (event.reportId !== GWOLVES_REPORT_ID)
+            return;
+        const response = new Uint8Array(event.data.buffer.slice(event.data.byteOffset, event.data.byteOffset + event.data.byteLength));
+        const waiter = this.waiter;
+        if (!waiter || response[0] !== waiter.command)
+            return;
+        window.clearTimeout(waiter.timer);
+        this.waiter = null;
+        waiter.resolve(response);
+    };
+    constructor(device) {
+        this.device = device;
+    }
+    // Only product ids present in GWOLVES_PRODUCTS (see ./products.ts) are
+    // accepted — this is the single place that catalog is consulted for
+    // device recognition, so adding a model is purely a data change there.
+    static isSupported(device) {
+        if (device.vendorId !== GWOLVES_VENDOR_ID)
+            return false;
+        if (!GWOLVES_PRODUCTS.has(device.productId))
+            return false;
+        return device.collections.some((collection) => collection.usagePage === 0xff02
+            && collection.inputReports.some((report) => report.reportId === GWOLVES_REPORT_ID && this.reportLength(report) === 16)
+            && collection.outputReports.some((report) => report.reportId === GWOLVES_REPORT_ID && this.reportLength(report) === 16));
+    }
+    get product() {
+        // isSupported() is always checked before a client is constructed (see
+        // registry.ts), so an unknown product id here means a caller bypassed
+        // that check rather than a real runtime case to handle gracefully.
+        const product = GWOLVES_PRODUCTS.get(this.device.productId);
+        if (!product)
+            throw new Error(`Unrecognized G-Wolves product id 0x${this.device.productId.toString(16)}.`);
+        return product;
+    }
+    isWirelessPath() {
+        return this.product.wireless;
+    }
+    get pollIntervalMs() {
+        return this.isWirelessPath() ? 10_000 : 30_000;
+    }
+    getDpiOptions() {
+        const values = [];
+        for (let dpi = 50; dpi <= 26_000; dpi += 50)
+            values.push(dpi);
+        return values;
+    }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+        this.device.removeEventListener("inputreport", this.onInputReport);
+        this.device.addEventListener("inputreport", this.onInputReport);
+    }
+    async readStatus() {
+        await this.open();
+        const { model, wireless } = this.product;
+        const batteryResponse = await this.transact(gwolvesBuildSimplePayload(GWOLVES_COMMAND.battery));
+        const firmwareResponse = await this.transact(gwolvesBuildSimplePayload(GWOLVES_COMMAND.firmware));
+        const profile = await this.readProfile();
+        const battery = gwolvesParseBattery(batteryResponse);
+        const settings = gwolvesDecodeProfile(profile);
+        const firmware = this.version(firmwareResponse);
+        return {
+            brand: "G-Wolves",
+            name: `G-Wolves ${model}`,
+            batteryPercent: battery?.percent ?? null,
+            batteryVoltageMv: battery?.voltageMv ?? null,
+            batteryState: battery
+                ? battery.charging ? (battery.percent >= 99 ? "Full" : "Charging") : "Discharging"
+                : "Unknown",
+            dpi: settings.dpi,
+            pollingRateHz: settings.pollingRateHz,
+            supportedPollingRates: SUPPORTED_POLLING_RATES,
+            activeProfile: null,
+            connectionType: wireless ? "Wireless" : "Wired",
+            connectionDetail: wireless ? "2.4 GHz receiver · 8K protocol" : "USB · 8K protocol",
+            motionSync: settings.motionSync,
+            debounceMs: settings.debounceMs,
+            sleepTimeout: settings.sleepTimeout === null ? null : settings.sleepTimeout / 10,
+            angleSnapping: settings.angleSnapping,
+            rippleControl: settings.rippleControl,
+            performanceMode: settings.performanceMode,
+            liftOffDistance: settings.liftOffDistance,
+            firmware: firmware ? [`Mouse ${firmware}`] : [],
+            ui: {
+                family: "vgn-f2",
+                hideUnsupportedPollingRates: true,
+                forceShowBattery: false,
+                pollingNote: `${model} supports 125 Hz through 8,000 Hz over its shared VGN-family protocol.`,
+                defaultDisplayName: `G-Wolves ${model}`,
+            },
+        };
+    }
+    async setDpi(dpi) {
+        const profile = gwolvesDecodeProfile(await this.readProfile());
+        const address = GWOLVES_ADDRESS.dpiStages + profile.activeDpiStage * 4;
+        await this.write(address, [...gwolvesEncodeDpi(dpi)]);
+        const confirmed = gwolvesDecodeProfile(await this.readProfile()).dpi;
+        if (confirmed !== dpi)
+            throw new Error(`The ${this.product.model} kept ${confirmed} DPI instead of ${dpi} DPI.`);
+        return confirmed;
+    }
+    async setPollingRate(rate) {
+        await this.writeScalar(GWOLVES_ADDRESS.pollingRate, gwolvesEncodePollingRate(rate));
+        const confirmed = gwolvesDecodeProfile(await this.readProfile()).pollingRateHz;
+        if (confirmed !== rate) {
+            const hint = this.isWirelessPath()
+                ? " (on the wireless path, the mouse must be actively awake — try moving it first)"
+                : "";
+            throw new Error(`The ${this.product.model} kept ${confirmed} Hz instead of ${rate} Hz.${hint}`);
+        }
+        return confirmed;
+    }
+    async setLiftOffDistance(value) {
+        const raw = value === "Low" ? 3 : value === "Medium" ? 1 : 2;
+        await this.writeScalar(GWOLVES_ADDRESS.lod, raw);
+        const confirmed = gwolvesDecodeProfile(await this.readProfile()).liftOffDistance;
+        if (confirmed !== value)
+            throw new Error(`The ${this.product.model} kept ${confirmed ?? "unknown"} LOD instead of ${value}.`);
+        return confirmed;
+    }
+    async close() {
+        this.failWaiter(new Error("The G-Wolves device was closed."));
+        this.device.removeEventListener("inputreport", this.onInputReport);
+        if (this.device.opened)
+            await this.device.close();
+    }
+    async readProfile() {
+        const profile = new Uint8Array(0xb7);
+        for (const [start, end] of [[0, 0x2c], [0xa8, 0xb7]]) {
+            for (let address = start; address < end; address += 10) {
+                const length = Math.min(10, end - address);
+                profile.set(await this.read(address, length), address);
+            }
+        }
+        return profile;
+    }
+    async read(address, length) {
+        const response = await this.transact(gwolvesBuildReadPayload(address, length));
+        const data = gwolvesParseReadResponse(response, address, length);
+        if (!data)
+            throw new Error(`${this.product.model} flash read failed at 0x${address.toString(16)}.`);
+        return data;
+    }
+    async writeScalar(address, value) {
+        const response = await this.transact(gwolvesBuildWriteScalarPayload(address, value));
+        if (!gwolvesReportChecksumIsValid(response) || response[0] !== GWOLVES_COMMAND.write || response[1] !== 0) {
+            throw new Error(`${this.product.model} flash write failed at 0x${address.toString(16)}.`);
+        }
+        const confirmed = await this.read(address, 2);
+        if (confirmed[0] !== value || ((confirmed[0] + confirmed[1]) & 0xff) !== 0x55) {
+            throw new Error(`The ${this.product.model} did not retain the value written at 0x${address.toString(16)}.`);
+        }
+    }
+    async write(address, data) {
+        const response = await this.transact(gwolvesBuildWritePayload(address, data));
+        if (!gwolvesReportChecksumIsValid(response) || response[0] !== GWOLVES_COMMAND.write || response[1] !== 0) {
+            throw new Error(`${this.product.model} flash write failed at 0x${address.toString(16)}.`);
+        }
+    }
+    async transact(payload) {
+        await this.open();
+        this.failWaiter(new Error("Superseded by another G-Wolves request."));
+        const command = payload[0];
+        const response = new Promise((resolve, reject) => {
+            const timer = window.setTimeout(() => {
+                if (this.waiter?.resolve === resolve)
+                    this.waiter = null;
+                reject(new Error(`Timed out waiting for G-Wolves command 0x${command.toString(16)}.`));
+            }, RESPONSE_TIMEOUT_MS);
+            this.waiter = { command, resolve, reject, timer };
+        });
+        try {
+            await this.device.sendReport(GWOLVES_REPORT_ID, new Uint8Array(payload).buffer);
+        }
+        catch (error) {
+            this.failWaiter(error instanceof Error ? error : new Error(String(error)));
+        }
+        return response;
+    }
+    version(response) {
+        if (!gwolvesReportChecksumIsValid(response) || response[0] !== GWOLVES_COMMAND.firmware || response[1] !== 0)
+            return null;
+        return `v${response[5] ?? 0}.${(response[6] ?? 0).toString(16).padStart(2, "0")}`;
+    }
+    failWaiter(error) {
+        const waiter = this.waiter;
+        if (!waiter)
+            return;
+        window.clearTimeout(waiter.timer);
+        this.waiter = null;
+        waiter.reject(error);
+    }
+    static reportLength(report) {
+        return report.items.reduce((sum, item) => sum + item.reportSize * item.reportCount, 0) / 8;
+    }
+}
+//# sourceMappingURL=hid.js.map

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

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

package/dist/drivers/gwolves/products.d.ts

@@ -0,0 +1,17 @@
+export interface GWolvesProduct {
+    model: string;
+    wireless: boolean;
+    /**
+     * Only `verified: true` entries have been exercised against real hardware
+     * by this project. Everything else would be a guess based on "probably
+     * the same shared VGN-family protocol as the HTX Ultra" and should not be
+     * assumed correct until actually tested — see PROTOCOL-NOTES.md in the
+     * HTX Ultra PR for how the verified entries were confirmed (live HID
+     * capture while using the official web driver at mouse.fit, cross-checked
+     * independently with hidapitester).
+     */
+    verified: boolean;
+}
+export declare const GWOLVES_VENDOR_ID = 13284;
+export declare const GWOLVES_PRODUCTS: ReadonlyMap<number, GWolvesProduct>;
+//# sourceMappingURL=products.d.ts.map

package/dist/drivers/gwolves/products.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../../src/drivers/gwolves/products.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;;;;OAQG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAuD/D,CAAC"}

package/dist/drivers/gwolves/products.js

@@ -0,0 +1,58 @@
+export const GWOLVES_VENDOR_ID = 0x33e4;
+export const GWOLVES_PRODUCTS = new Map([
+    [0x5618, { model: "HTX Ultra", wireless: false, verified: true }],
+    [0x3854, { model: "HTX Ultra", wireless: true, verified: true }],
+    // Everything below is transcribed from G-Wolves' own live web-driver config
+    // (mouse.xyz's env-models.json, fetched 2026-08-30 — every entry shares the
+    // HTX Ultra's vendor id 0x33e4 and "IsNewProtocol": "1"), not independently
+    // hardware-tested. Add further G-Wolves models here as they're
+    // captured/verified — but confirm with a real capture before setting
+    // verified: true, since a wrong address/encoding on an unverified model
+    // could silently write the wrong value rather than fail loudly.
+    [0x3808, { model: "HTM Plus", wireless: false, verified: false }],
+    [0x3817, { model: "HTM Plus", wireless: true, verified: false }],
+    [0x6808, { model: "HSK Pro 2.0", wireless: false, verified: false }],
+    [0x6817, { model: "HSK Pro 2.0", wireless: true, verified: false }],
+    [0x5608, { model: "HTXU", wireless: false, verified: false }],
+    [0x5617, { model: "HTXU", wireless: true, verified: false }],
+    [0x3608, { model: "Fenrir Pro", wireless: false, verified: false }],
+    [0x3617, { model: "Fenrir Pro", wireless: true, verified: false }],
+    [0x3908, { model: "VUK", wireless: false, verified: false }],
+    [0x3917, { model: "VUK", wireless: true, verified: false }],
+    [0x7904, { model: "HT-S2", wireless: false, verified: false }],
+    [0x7913, { model: "HT-S2", wireless: true, verified: false }],
+    [0x3708, { model: "Fenir Max", wireless: false, verified: false }],
+    [0x3717, { model: "Fenir Max", wireless: true, verified: false }],
+    [0x5308, { model: "HTS Ultra", wireless: false, verified: false }],
+    [0x5317, { model: "HTS Ultra", wireless: true, verified: false }],
+    [0x7704, { model: "HTR", wireless: false, verified: false }],
+    [0x7713, { model: "HTR", wireless: true, verified: false }],
+    [0x3508, { model: "Fenrir", wireless: false, verified: false }],
+    [0x3517, { model: "Fenrir", wireless: true, verified: false }],
+    [0x7908, { model: "HT-S2 Pro", wireless: false, verified: false }],
+    [0x7917, { model: "HT-S2 Pro", wireless: true, verified: false }],
+    [0x5808, { model: "HSK Pro", wireless: false, verified: false }],
+    [0x5817, { model: "HSK Pro", wireless: true, verified: false }],
+    [0x2708, { model: "HTX Mini", wireless: false, verified: false }],
+    [0x2717, { model: "HTX Mini", wireless: true, verified: false }],
+    [0x5408, { model: "HTS Plus", wireless: false, verified: false }],
+    [0x5417, { model: "HTS Plus", wireless: true, verified: false }],
+    [0x5708, { model: "HTX", wireless: false, verified: false }],
+    [0x5717, { model: "HTX", wireless: true, verified: false }],
+    [0x5908, { model: "HSK Plus", wireless: false, verified: false }],
+    [0x5917, { model: "HSK Plus", wireless: true, verified: false }],
+    [0x7708, { model: "HTR Pro", wireless: false, verified: false }],
+    [0x7717, { model: "HTR Pro", wireless: true, verified: false }],
+    [0x5804, { model: "HSK Pro ACE", wireless: false, verified: false }],
+    [0x5803, { model: "HSK Pro ACE", wireless: true, verified: false }],
+    [0x5404, { model: "HTS Plus ACE", wireless: false, verified: false }],
+    [0x5403, { model: "HTS Plus ACE", wireless: true, verified: false }],
+    [0x5704, { model: "HTX ACE", wireless: false, verified: false }],
+    [0x5703, { model: "HTX ACE", wireless: true, verified: false }],
+    [0x5904, { model: "HSK Plus ACE", wireless: false, verified: false }],
+    [0x5903, { model: "HSK Plus ACE", wireless: true, verified: false }],
+    // "TEST HTS Plus" in that config (wired 0x5428, wireless 0x3854) is
+    // deliberately skipped: its own name marks it a dev/test entry, and its
+    // wireless id collides with the already-verified HTX Ultra's 0x3854.
+]);
+//# sourceMappingURL=products.js.map

package/dist/drivers/gwolves/products.js.map

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

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

@@ -0,0 +1,59 @@
+import type { MouseStatus } from "../mouse-types.ts";
+import { type DpiSettings } from "@openmouse/protocol/hyperx";
+/**
+ * HyperX Pulsefire Haste — WebHID client.
+ *
+ * The config channel is a single vendor collection (usage page 0xFF00, usage
+ * 0x01) carrying one 64-byte **output** report and one 64-byte **input**
+ * report.  It declares no feature report, so this driver transfers through
+ * `sendReport()` / the `inputreport` event instead of `sendFeatureReport()`.
+ *
+ * Reads (0x46/0x50/0x51/0x53/0x54) echo the request's opcode at byte 0 of
+ * their reply; writes (0xD0/0xD3/0xDE) are fire-and-forget and must be
+ * confirmed by re-reading the matching getter.
+ *
+ * The mouse is write-direct: DPI writes target onboard profile 0 (the profile
+ * NGENUITY opens as "Profile 1") and are persisted with a SAVE packet, then
+ * re-read through the 0x53 DPI-settings report so staged values are confirmed
+ * rather than assumed.
+ */
+export declare class HyperXHidClient {
+    readonly device: HIDDevice;
+    private onReport;
+    private inbox;
+    constructor(device: HIDDevice);
+    static isSupported(device: HIDDevice): boolean;
+    get supportedPollingRates(): number[];
+    getDpiOptions(): number[];
+    open(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Send a 64-byte output report and wait for a reply echoing `opcode` at byte
+     * 0.  Other interfaces (mouse input, keyboard) share this HIDDevice; their
+     * reports are filtered out by length and opcode.
+     */
+    sendQuery(opcode: number): Promise<Uint8Array>;
+    /** Fire-and-forget write; no reply is expected. */
+    private sendCommand;
+    private delay;
+    getHardwareInfo(): Promise<{
+        firmware: string;
+        product: string;
+    }>;
+    getConnection(): Promise<{
+        type: "Wired" | "Wireless" | null;
+        detail: string;
+    }>;
+    getBattery(): Promise<{
+        percent: number | null;
+        state: "Charging" | "Discharging" | "Full" | "Unknown";
+    }>;
+    getDpiSettings(): Promise<DpiSettings | null>;
+    setDpi(dpi: number, dpiY?: number): Promise<number>;
+    setPollingRate(rate: number): Promise<number>;
+    setLiftOffDistance(value: NonNullable<MouseStatus["liftOffDistance"]>): Promise<void>;
+    /** Re-read DPI settings until they match, tolerating fire-and-forget write latency. */
+    private confirmDpi;
+    readStatus(): Promise<MouseStatus>;
+}
+//# sourceMappingURL=hid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/hyperx/hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAiBL,KAAK,WAAW,EAEjB,MAAM,4BAA4B,CAAC;AAYpC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAuD;IACvE,OAAO,CAAC,KAAK,CAAoB;gBAErB,MAAM,EAAE,SAAS;IAI7B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAY9C,IAAI,qBAAqB,IAAI,MAAM,EAAE,CAEpC;IAED,aAAa,IAAI,MAAM,EAAE;IAInB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAcrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAcpD,mDAAmD;YACrC,WAAW;IAKzB,OAAO,CAAC,KAAK;IAQP,eAAe,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IASjE,aAAa,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAM/E,UAAU,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,UAAU,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAKzG,cAAc,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAS7C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBxD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7C,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3F,uFAAuF;YACzE,UAAU;IAalB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;CAkDzC"}

package/dist/drivers/hyperx/hid.js

@@ -0,0 +1,229 @@
+import { CMD, HYPERX_USAGE, HYPERX_USAGE_PAGE, HYPERX_VENDOR_ID_HP, HYPERX_VENDOR_ID_KINGSTON, SUPPORTED_POLLING_RATES, decodeBattery, decodeConnection, decodeDpiSettings, decodeHardwareInfo, dpiOptions, encodeSave, encodeSetDpi, encodeSetLod, encodeSetPollingRate, isValidDpi, } from "@openmouse/protocol/hyperx";
+const REPORT_SIZE = 64;
+const RESPONSE_TIMEOUT_MS = 500;
+const RESPONSE_POLL_MS = 5;
+const WRITE_SETTLE_MS = 60;
+const WRITE_CONFIRM_ATTEMPTS = 5;
+function hex(value) {
+    return `0x${value.toString(16).padStart(2, "0")}`;
+}
+/**
+ * HyperX Pulsefire Haste — WebHID client.
+ *
+ * The config channel is a single vendor collection (usage page 0xFF00, usage
+ * 0x01) carrying one 64-byte **output** report and one 64-byte **input**
+ * report.  It declares no feature report, so this driver transfers through
+ * `sendReport()` / the `inputreport` event instead of `sendFeatureReport()`.
+ *
+ * Reads (0x46/0x50/0x51/0x53/0x54) echo the request's opcode at byte 0 of
+ * their reply; writes (0xD0/0xD3/0xDE) are fire-and-forget and must be
+ * confirmed by re-reading the matching getter.
+ *
+ * The mouse is write-direct: DPI writes target onboard profile 0 (the profile
+ * NGENUITY opens as "Profile 1") and are persisted with a SAVE packet, then
+ * re-read through the 0x53 DPI-settings report so staged values are confirmed
+ * rather than assumed.
+ */
+export class HyperXHidClient {
+    device;
+    onReport = null;
+    inbox = [];
+    constructor(device) {
+        this.device = device;
+    }
+    static isSupported(device) {
+        const vid = device.vendorId;
+        if (vid !== HYPERX_VENDOR_ID_KINGSTON && vid !== HYPERX_VENDOR_ID_HP)
+            return false;
+        const hasVendorCollection = (collections) => collections.some((collection) => (collection.usagePage === HYPERX_USAGE_PAGE && collection.usage === HYPERX_USAGE) ||
+            hasVendorCollection(collection.children));
+        return hasVendorCollection(device.collections);
+    }
+    get supportedPollingRates() {
+        return [...SUPPORTED_POLLING_RATES];
+    }
+    getDpiOptions() {
+        return dpiOptions();
+    }
+    async open() {
+        if (!this.device.opened)
+            await this.device.open();
+        if (!this.onReport) {
+            this.inbox = [];
+            this.onReport = (event) => {
+                const data = new Uint8Array(event.data.buffer, event.data.byteOffset, event.data.byteLength);
+                if (data.length >= REPORT_SIZE) {
+                    this.inbox.push(data.subarray(0, REPORT_SIZE));
+                }
+            };
+            this.device.addEventListener("inputreport", this.onReport);
+        }
+    }
+    async close() {
+        if (this.onReport) {
+            this.device.removeEventListener("inputreport", this.onReport);
+            this.onReport = null;
+        }
+        this.inbox = [];
+        if (this.device.opened)
+            await this.device.close();
+    }
+    // ---------------------------------------------------------------------------
+    // Report I/O
+    // ---------------------------------------------------------------------------
+    /**
+     * Send a 64-byte output report and wait for a reply echoing `opcode` at byte
+     * 0.  Other interfaces (mouse input, keyboard) share this HIDDevice; their
+     * reports are filtered out by length and opcode.
+     */
+    async sendQuery(opcode) {
+        await this.open();
+        const buf = new Uint8Array(REPORT_SIZE);
+        buf[0] = opcode;
+        const deadline = performance.now() + RESPONSE_TIMEOUT_MS;
+        await this.device.sendReport(0, buf);
+        while (performance.now() < deadline) {
+            const index = this.inbox.findIndex((candidate) => candidate[0] === opcode);
+            if (index !== -1)
+                return this.inbox.splice(index, 1)[0];
+            await this.delay(RESPONSE_POLL_MS);
+        }
+        throw new Error(`HyperX command ${hex(opcode)} was not answered.`);
+    }
+    /** Fire-and-forget write; no reply is expected. */
+    async sendCommand(buf) {
+        await this.open();
+        await this.device.sendReport(0, buf.buffer);
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    // ---------------------------------------------------------------------------
+    // Reads
+    // ---------------------------------------------------------------------------
+    async getHardwareInfo() {
+        const resp = await this.sendQuery(CMD.GET_HARDWARE_INFO);
+        const info = decodeHardwareInfo(resp);
+        return {
+            firmware: info?.firmware ?? "unknown",
+            product: info?.product ?? this.device.productName ?? "",
+        };
+    }
+    async getConnection() {
+        const resp = await this.sendQuery(CMD.GET_CONNECTION);
+        const type = decodeConnection(resp);
+        return { type, detail: type === "Wireless" ? "2.4 GHz receiver" : type === "Wired" ? "USB" : "" };
+    }
+    async getBattery() {
+        const resp = await this.sendQuery(CMD.GET_BATTERY);
+        return decodeBattery(resp) ?? { percent: null, state: "Unknown" };
+    }
+    async getDpiSettings() {
+        const resp = await this.sendQuery(CMD.GET_DPI);
+        return decodeDpiSettings(resp);
+    }
+    // ---------------------------------------------------------------------------
+    // Writes
+    // ---------------------------------------------------------------------------
+    async setDpi(dpi, dpiY = dpi) {
+        if (!isValidDpi(dpi) || !isValidDpi(dpiY)) {
+            throw new Error("HyperX DPI must be 200–16,000 in 100 DPI steps.");
+        }
+        await this.open();
+        for (const [profile, value] of [[0, dpi], [1, dpiY]]) {
+            const buf = encodeSetDpi(profile, value);
+            if (buf)
+                await this.sendCommand(buf);
+        }
+        const save = encodeSave(0x03);
+        await this.sendCommand(save);
+        await this.delay(WRITE_SETTLE_MS);
+        const confirmed = await this.confirmDpi((settings) => settings !== null && settings.profiles[0] === dpi);
+        if (confirmed && confirmed.profiles[0] !== dpi) {
+            throw new Error(`The mouse kept ${confirmed.profiles[0].toLocaleString()} DPI instead of ${dpi.toLocaleString()}.`);
+        }
+        return confirmed?.profiles[0] ?? dpi;
+    }
+    async setPollingRate(rate) {
+        if (!SUPPORTED_POLLING_RATES.includes(rate)) {
+            throw new Error(`HyperX supports ${SUPPORTED_POLLING_RATES.join(", ")} Hz.`);
+        }
+        const buf = encodeSetPollingRate(rate);
+        if (!buf)
+            throw new Error(`Failed to encode polling rate ${rate} Hz.`);
+        await this.sendCommand(buf);
+        await this.delay(WRITE_SETTLE_MS);
+        return rate;
+    }
+    async setLiftOffDistance(value) {
+        if (value !== "Low" && value !== "High") {
+            throw new Error("HyperX supports 1 mm (Low) or 2 mm (High) lift-off distance.");
+        }
+        const buf = encodeSetLod(value);
+        await this.sendCommand(buf);
+        const save = encodeSave(0x03);
+        await this.sendCommand(save);
+        await this.delay(WRITE_SETTLE_MS);
+        const confirmed = await this.confirmDpi((settings) => settings !== null && settings.liftOffDistance === value);
+        if (confirmed && confirmed.liftOffDistance !== value) {
+            throw new Error(`The mouse kept ${confirmed.liftOffDistance ?? "an unknown"} lift-off distance instead of ${value}.`);
+        }
+    }
+    /** Re-read DPI settings until they match, tolerating fire-and-forget write latency. */
+    async confirmDpi(matches) {
+        let settings = await this.getDpiSettings().catch(() => null);
+        for (let attempt = 1; attempt < WRITE_CONFIRM_ATTEMPTS && !matches(settings); attempt += 1) {
+            await this.delay(WRITE_SETTLE_MS);
+            settings = await this.getDpiSettings().catch(() => null);
+        }
+        return settings;
+    }
+    // ---------------------------------------------------------------------------
+    // High-level API
+    // ---------------------------------------------------------------------------
+    async readStatus() {
+        await this.open();
+        // Hardware info must answer, or this is not a HyperX config interface.
+        const [infoResult, dpiResult, batteryResult, connectionResult] = await Promise.allSettled([
+            this.getHardwareInfo(),
+            this.getDpiSettings(),
+            this.getBattery(),
+            this.getConnection(),
+        ]);
+        if (infoResult.status === "rejected") {
+            throw new Error(`HyperX control interface did not answer hardware info. ${infoResult.reason}`);
+        }
+        const info = infoResult.value;
+        const dpi = dpiResult.status === "fulfilled" ? dpiResult.value : null;
+        const battery = batteryResult.status === "fulfilled" ? batteryResult.value : null;
+        const connection = connectionResult.status === "fulfilled" ? connectionResult.value : null;
+        const activeDpi = dpi?.profiles[dpi.activeProfile] ?? dpi?.profiles[0] ?? 1600;
+        const isWireless = connection?.type === "Wireless";
+        const settingsReady = dpi !== null;
+        return {
+            brand: "HyperX",
+            name: info.product || this.device.productName || "HyperX Mouse",
+            ui: {
+                family: "hyperx",
+                settingsReady,
+                hideLodLow: false,
+                hideUnsupportedPollingRates: true,
+                hideProcessingCard: true,
+                defaultDisplayName: info.product || this.device.productName || "HyperX Mouse",
+            },
+            batteryPercent: isWireless ? battery?.percent ?? null : null,
+            batteryState: isWireless ? battery?.state ?? "Unknown" : "Unknown",
+            dpi: activeDpi,
+            dpiY: activeDpi,
+            pollingRateHz: 1000,
+            supportedPollingRates: this.supportedPollingRates,
+            activeProfile: dpi?.activeProfile ?? null,
+            connectionType: connection?.type ?? (isWireless ? "Wireless" : "Wired"),
+            connectionDetail: connection?.detail,
+            liftOffDistance: dpi?.liftOffDistance ?? null,
+            supportedLiftOffDistances: ["Low", "High"],
+            firmware: info.firmware ? [`Mouse v${info.firmware}`] : [],
+        };
+    }
+}
+//# sourceMappingURL=hid.js.map

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

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