dualsense-ts 6.3.0 → 6.4.0

package/dist/hid/dualsense_hid.d.ts

@@ -1,7 +1,11 @@
 import { PulseOptions, Brightness } from "./command";
 import { HIDProvider, DualsenseHIDState } from "./hid_provider";
+import { FirmwareInfo } from "./firmware_info";
+import { FactoryInfo } from "./factory_info";
 export type HIDCallback = (state: DualsenseHIDState) => void;
 export type ErrorCallback = (error: Error) => void;
+export type ReadyCallback = () => void;
+export type ConnectionCallback = (connected: boolean) => void;
 /** Coordinates a HIDProvider and tracks the latest HID state */
 export declare class DualsenseHID {
     readonly provider: HIDProvider;
@@ -9,10 +13,26 @@ export declare class DualsenseHID {
     private readonly subscribers;
     /** Subscribers waiting for error updates */
     private readonly errorSubscribers;
+    /** Subscribers waiting for firmware/factory info to become available */
+    private readonly readySubscribers;
+    /** Subscribers tracking transport-level connect/disconnect events */
+    private readonly connectionSubscribers;
+    /** True once firmware/factory info has been loaded for the current connection */
+    private identityResolved;
+    /** Pending retry timer for identity loading after a transient failure */
+    private identityRetryTimer?;
+    /** Number of identity-load attempts made for the current connection */
+    private identityRetryCount;
     /** Queue of pending HID commands */
     private pendingCommands;
     /** Most recent HID state of the device */
     state: DualsenseHIDState;
+    /** Firmware and hardware information, populated after connection */
+    firmwareInfo: FirmwareInfo;
+    /** Factory information (serial, color, board revision), populated after connection */
+    factoryInfo: FactoryInfo;
+    /** Bluetooth MAC address from Feature Report 0x09, populated after connection */
+    macAddress?: string;
     constructor(provider: HIDProvider, refreshRate?: number);
     get wireless(): boolean;
     /** Register a handler for HID state updates */
@@ -21,10 +41,67 @@ export declare class DualsenseHID {
     unregister(callback: HIDCallback): void;
     /** Add a subscriber for errors */
     on(type: "error" | string, callback: ErrorCallback): void;
+    /**
+     * Subscribe to notification when firmware/factory info finishes loading
+     * after a connect. Fires once per connection — either when identity has
+     * been resolved, or when we've given up retrying. If identity is already
+     * resolved at the time of subscription, the callback fires synchronously.
+     */
+    onReady(callback: ReadyCallback): () => void;
+    /** True if firmware/factory info has been loaded (or given up on) for the current connection */
+    get ready(): boolean;
+    /**
+     * Subscribe to transport-level connect/disconnect events. Useful for
+     * mirroring connection state into an Input without polling. Returns
+     * an unsubscribe function.
+     */
+    onConnectionChange(callback: ConnectionCallback): () => void;
+    /**
+     * Stable hardware identity for this controller, derived from the most
+     * trustworthy info available. Prefers the Bluetooth MAC address (from
+     * Feature Report 0x09, works on every transport and platform), then
+     * falls back to the factory serial, then firmware deviceInfo.
+     * Returns undefined until identity info has been read.
+     */
+    get identity(): string | undefined;
     /** Update the HID state and pass it along to all state subscribers */
     private set;
     /** Pass errors along to all error subscribers */
     private handleError;
+    /** Maximum identity-load retry attempts per connection */
+    private static readonly IDENTITY_MAX_ATTEMPTS;
+    /** Backoff schedule (ms) for identity-load retries */
+    private static readonly IDENTITY_BACKOFF_MS;
+    /**
+     * Attempt to read firmware + factory info for the current connection,
+     * with retry on failure. Marks identity as resolved on success or after
+     * exhausting all attempts (so consumers don't wait forever).
+     *
+     * If cached firmware/factory info exists from a prior session, identity
+     * is resolved immediately (so the connection event has full details),
+     * then a background verification re-reads the device to confirm.
+     */
+    private loadIdentity;
+    /** Mark identity loading as complete and notify subscribers */
+    private markIdentityResolved;
+    /** Cancel any pending identity-load retry */
+    private cancelIdentityRetry;
+    /** In-flight firmware info fetch, deduped across callers within a connection */
+    private firmwareFetch?;
+    /** In-flight factory info fetch, deduped across callers within a connection */
+    private factoryFetch?;
+    /**
+     * Read firmware info from the controller (Feature Report 0x20).
+     * Idempotent: returns the cached value if already fetched, or the
+     * in-flight promise if a fetch is already underway.
+     */
+    fetchFirmwareInfo(): Promise<FirmwareInfo>;
+    /**
+     * Read factory info (serial number, body color, board revision) from the controller.
+     * Requires firmware info to be fetched first for feature gating.
+     * Idempotent across the lifetime of a single connection.
+     */
+    fetchFactoryInfo(): Promise<FactoryInfo>;
     /** Condense all pending commands into one HID feature report */
     private static buildFeatureReport;
     /** Set intensity for left and right rumbles */

package/dist/hid/dualsense_hid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dualsense_hid.d.ts","sourceRoot":"","sources":["../../src/hid/dualsense_hid.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EACL,WAAW,EACX,iBAAiB,EAElB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAenD,gEAAgE;AAChE,qBAAa,YAAY;IAWrB,QAAQ,CAAC,QAAQ,EAAE,WAAW;IAVhC,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4B;IAC7D,oCAAoC;IACpC,OAAO,CAAC,eAAe,CAAsB;IAC7C,0CAA0C;IACnC,KAAK,EAAE,iBAAiB,CAAmC;gBAGvD,QAAQ,EAAE,WAAW,EAC9B,WAAW,GAAE,MAAW;IAyB1B,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,+CAA+C;IACxC,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAI5C,6CAA6C;IACtC,UAAU,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAI9C,kCAAkC;IAC3B,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIhE,sEAAsE;IACtE,OAAO,CAAC,GAAG;IAKX,iDAAiD;IACjD,OAAO,CAAC,WAAW;IAInB,gEAAgE;IAChE,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAiDjC,+CAA+C;IACxC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAiBnD,2DAA2D;IACpD,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAOtD,4DAA4D;IACrD,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAOvD,mCAAmC;IAC5B,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI;IAO1C,oEAAoE;IAC7D,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,UAA4B,GAAG,IAAI;IAWrF,+CAA+C;IACxC,WAAW,CAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,GAAE,YAA+B,GACrC,IAAI;CAkBR"}
+{"version":3,"file":"dualsense_hid.d.ts","sourceRoot":"","sources":["../../src/hid/dualsense_hid.ts"],"names":[],"mappings":"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"}

package/dist/hid/dualsense_hid.js

@@ -4,6 +4,9 @@ exports.DualsenseHID = void 0;
 const command_1 = require("./command");
 const hid_provider_1 = require("./hid_provider");
 const bt_checksum_1 = require("./bt_checksum");
+const firmware_info_1 = require("./firmware_info");
+const factory_info_1 = require("./factory_info");
+const pairing_info_1 = require("./pairing_info");
 const SCOPE_A = 1;
 const SCOPE_B = 2;
 /** Coordinates a HIDProvider and tracks the latest HID state */
@@ -14,12 +17,42 @@ class DualsenseHID {
         this.subscribers = new Set();
         /** Subscribers waiting for error updates */
         this.errorSubscribers = new Set();
+        /** Subscribers waiting for firmware/factory info to become available */
+        this.readySubscribers = new Set();
+        /** Subscribers tracking transport-level connect/disconnect events */
+        this.connectionSubscribers = new Set();
+        /** True once firmware/factory info has been loaded for the current connection */
+        this.identityResolved = false;
+        /** Number of identity-load attempts made for the current connection */
+        this.identityRetryCount = 0;
         /** Queue of pending HID commands */
         this.pendingCommands = [];
         /** Most recent HID state of the device */
         this.state = { ...hid_provider_1.DefaultDualsenseHIDState };
+        /** Firmware and hardware information, populated after connection */
+        this.firmwareInfo = firmware_info_1.DefaultFirmwareInfo;
+        /** Factory information (serial, color, board revision), populated after connection */
+        this.factoryInfo = factory_info_1.DefaultFactoryInfo;
         provider.onData = this.set.bind(this);
         provider.onError = this.handleError.bind(this);
+        provider.onConnect = () => {
+            // Keep cached firmware/factory info from the prior session so that
+            // consumers see identity details immediately on a reconnection
+            // event. The background loadIdentity() call will verify and refresh
+            // the cache — if the hardware identity turns out different (e.g. a
+            // different controller grabbed the same slot), the fields get
+            // overwritten then.
+            this.firmwareFetch = undefined;
+            this.factoryFetch = undefined;
+            this.identityResolved = false;
+            this.cancelIdentityRetry();
+            this.connectionSubscribers.forEach((cb) => cb(true));
+            void this.loadIdentity();
+        };
+        provider.onDisconnect = () => {
+            this.cancelIdentityRetry();
+            this.connectionSubscribers.forEach((cb) => cb(false));
+        };
         setInterval(() => {
             if (this.pendingCommands.length > 0) {
                 (async () => {
@@ -48,6 +81,52 @@ class DualsenseHID {
         if (type === "error")
             this.errorSubscribers.add(callback);
     }
+    /**
+     * Subscribe to notification when firmware/factory info finishes loading
+     * after a connect. Fires once per connection — either when identity has
+     * been resolved, or when we've given up retrying. If identity is already
+     * resolved at the time of subscription, the callback fires synchronously.
+     */
+    onReady(callback) {
+        if (this.identityResolved) {
+            callback();
+            return () => { };
+        }
+        this.readySubscribers.add(callback);
+        return () => this.readySubscribers.delete(callback);
+    }
+    /** True if firmware/factory info has been loaded (or given up on) for the current connection */
+    get ready() {
+        return this.identityResolved;
+    }
+    /**
+     * Subscribe to transport-level connect/disconnect events. Useful for
+     * mirroring connection state into an Input without polling. Returns
+     * an unsubscribe function.
+     */
+    onConnectionChange(callback) {
+        this.connectionSubscribers.add(callback);
+        return () => this.connectionSubscribers.delete(callback);
+    }
+    /**
+     * Stable hardware identity for this controller, derived from the most
+     * trustworthy info available. Prefers the Bluetooth MAC address (from
+     * Feature Report 0x09, works on every transport and platform), then
+     * falls back to the factory serial, then firmware deviceInfo.
+     * Returns undefined until identity info has been read.
+     */
+    get identity() {
+        if (this.macAddress) {
+            return `mac:${this.macAddress}`;
+        }
+        if (this.factoryInfo.serialNumber !== factory_info_1.DefaultFactoryInfo.serialNumber) {
+            return `serial:${this.factoryInfo.serialNumber}`;
+        }
+        if (this.firmwareInfo.deviceInfo !== firmware_info_1.DefaultFirmwareInfo.deviceInfo) {
+            return `device:${this.firmwareInfo.deviceInfo}`;
+        }
+        return undefined;
+    }
     /** Update the HID state and pass it along to all state subscribers */
     set(state) {
         this.state = state;
@@ -57,6 +136,116 @@ class DualsenseHID {
     handleError(error) {
         this.errorSubscribers.forEach((callback) => callback(error));
     }
+    /**
+     * Attempt to read firmware + factory info for the current connection,
+     * with retry on failure. Marks identity as resolved on success or after
+     * exhausting all attempts (so consumers don't wait forever).
+     *
+     * If cached firmware/factory info exists from a prior session, identity
+     * is resolved immediately (so the connection event has full details),
+     * then a background verification re-reads the device to confirm.
+     */
+    async loadIdentity() {
+        if (!this.provider.connected)
+            return;
+        // Fast path: if we already have cached identity from a prior session,
+        // mark resolved immediately so consumers see it on the connection event.
+        // Then continue to the verification read below.
+        const hadCachedIdentity = this.identity !== undefined;
+        if (hadCachedIdentity) {
+            this.markIdentityResolved();
+        }
+        this.identityRetryCount += 1;
+        try {
+            // Read MAC address first — simple feature report, no firmware gate.
+            const mac = await (0, pairing_info_1.readMacAddress)(this.provider);
+            if (mac)
+                this.macAddress = mac;
+            // Always read fresh from the device (bypass the idempotency cache).
+            const fw = await (0, firmware_info_1.readFirmwareInfo)(this.provider);
+            if (fw) {
+                this.firmwareInfo = fw;
+                this.firmwareFetch = Promise.resolve(fw);
+                const fi = await (0, factory_info_1.readFactoryInfo)(this.provider, fw.hardwareInfo, fw.mainFirmwareVersionRaw);
+                this.factoryInfo = fi ?? factory_info_1.DefaultFactoryInfo;
+                this.factoryFetch = Promise.resolve(this.factoryInfo);
+                if (!hadCachedIdentity) {
+                    this.markIdentityResolved();
+                }
+                return;
+            }
+        }
+        catch {
+            // Treat throws the same as undefined — fall through to retry logic.
+        }
+        // Failure — clear in-flight promises so the next attempt can retry.
+        this.firmwareFetch = undefined;
+        this.factoryFetch = undefined;
+        if (this.identityRetryCount >= DualsenseHID.IDENTITY_MAX_ATTEMPTS ||
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            !this.provider.connected) {
+            this.markIdentityResolved();
+            return;
+        }
+        const delay = DualsenseHID.IDENTITY_BACKOFF_MS[Math.min(this.identityRetryCount - 1, DualsenseHID.IDENTITY_BACKOFF_MS.length - 1)];
+        this.identityRetryTimer = setTimeout(() => {
+            this.identityRetryTimer = undefined;
+            void this.loadIdentity();
+        }, delay);
+    }
+    /** Mark identity loading as complete and notify subscribers */
+    markIdentityResolved() {
+        if (this.identityResolved)
+            return;
+        this.identityResolved = true;
+        this.identityRetryCount = 0;
+        const callbacks = Array.from(this.readySubscribers);
+        this.readySubscribers.clear();
+        callbacks.forEach((cb) => cb());
+    }
+    /** Cancel any pending identity-load retry */
+    cancelIdentityRetry() {
+        if (this.identityRetryTimer) {
+            clearTimeout(this.identityRetryTimer);
+            this.identityRetryTimer = undefined;
+        }
+        this.identityRetryCount = 0;
+    }
+    /**
+     * Read firmware info from the controller (Feature Report 0x20).
+     * Idempotent: returns the cached value if already fetched, or the
+     * in-flight promise if a fetch is already underway.
+     */
+    fetchFirmwareInfo() {
+        if (this.firmwareInfo !== firmware_info_1.DefaultFirmwareInfo)
+            return Promise.resolve(this.firmwareInfo);
+        if (this.firmwareFetch)
+            return this.firmwareFetch;
+        this.firmwareFetch = (0, firmware_info_1.readFirmwareInfo)(this.provider).then((info) => {
+            this.firmwareInfo = info ?? firmware_info_1.DefaultFirmwareInfo;
+            return this.firmwareInfo;
+        });
+        return this.firmwareFetch;
+    }
+    /**
+     * Read factory info (serial number, body color, board revision) from the controller.
+     * Requires firmware info to be fetched first for feature gating.
+     * Idempotent across the lifetime of a single connection.
+     */
+    fetchFactoryInfo() {
+        if (this.factoryInfo !== factory_info_1.DefaultFactoryInfo)
+            return Promise.resolve(this.factoryInfo);
+        if (this.factoryFetch)
+            return this.factoryFetch;
+        if (this.firmwareInfo === firmware_info_1.DefaultFirmwareInfo)
+            return Promise.resolve(factory_info_1.DefaultFactoryInfo);
+        const fwInfo = this.firmwareInfo;
+        this.factoryFetch = (0, factory_info_1.readFactoryInfo)(this.provider, fwInfo.hardwareInfo, fwInfo.mainFirmwareVersionRaw).then((info) => {
+            this.factoryInfo = info ?? factory_info_1.DefaultFactoryInfo;
+            return this.factoryInfo;
+        });
+        return this.factoryFetch;
+    }
     /** Condense all pending commands into one HID feature report */
     static buildFeatureReport(events, wireless) {
         const usbReport = new Uint8Array(48).fill(0);
@@ -168,4 +357,8 @@ class DualsenseHID {
     }
 }
 exports.DualsenseHID = DualsenseHID;
+/** Maximum identity-load retry attempts per connection */
+DualsenseHID.IDENTITY_MAX_ATTEMPTS = 5;
+/** Backoff schedule (ms) for identity-load retries */
+DualsenseHID.IDENTITY_BACKOFF_MS = [500, 1500, 3000, 5000];
 //# sourceMappingURL=dualsense_hid.js.map

package/dist/hid/dualsense_hid.js.map

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

package/dist/hid/factory_info.d.ts

@@ -0,0 +1,53 @@
+import { HIDProvider } from "./hid_provider";
+/** Known DualSense body colors */
+export declare enum DualsenseColor {
+    Unknown = "Unknown",
+    White = "White",
+    MidnightBlack = "Midnight Black",
+    CosmicRed = "Cosmic Red",
+    NovaPink = "Nova Pink",
+    GalacticPurple = "Galactic Purple",
+    StarlightBlue = "Starlight Blue",
+    GreyCamouflage = "Grey Camouflage",
+    VolcanicRed = "Volcanic Red",
+    SterlingSilver = "Sterling Silver",
+    CobaltBlue = "Cobalt Blue",
+    ChromaTeal = "Chroma Teal",
+    ChromaIndigo = "Chroma Indigo",
+    ChromaPearl = "Chroma Pearl",
+    Anniversary30th = "30th Anniversary",
+    GodOfWarRagnarok = "God of War Ragnarok",
+    SpiderMan2 = "Spider-Man 2",
+    AstroBot = "Astro Bot",
+    Fortnite = "Fortnite",
+    TheLastOfUs = "The Last of Us",
+    IconBlueLimitedEdition = "Icon Blue Limited Edition",
+    GenshinImpact = "Genshin Impact"
+}
+/** Known DualSense body colors, keyed by the 2-char code from the serial number */
+export declare const DualsenseColorMap: Record<string, DualsenseColor>;
+/** Factory information derived from the controller's serial number */
+export interface FactoryInfo {
+    /** Raw serial number string */
+    serialNumber: string;
+    /** Controller body color name (e.g. "Cosmic Red") */
+    colorName: string;
+    /** Raw 2-character color code from the serial number */
+    colorCode: string;
+    /** Board revision (e.g. "BDM-030") */
+    boardRevision: string;
+}
+/** Default FactoryInfo used when the test command protocol is unavailable (e.g. Linux Bluetooth via node-hid) */
+export declare const DefaultFactoryInfo: FactoryInfo;
+/**
+ * Read factory info (serial number, body color, board revision) from a connected controller.
+ *
+ * Requires firmware support: hardwareInfo >= 777 and mainFirmwareVersion >= 65655.
+ * Use the values from FirmwareInfo (Feature Report 0x20) to check this gate.
+ *
+ * @param provider The HID provider for the connected controller
+ * @param hardwareInfo Hardware info word from FirmwareInfo
+ * @param mainFwVersionRaw Raw uint32 main firmware version from FirmwareInfo
+ */
+export declare function readFactoryInfo(provider: HIDProvider, hardwareInfo: number, mainFwVersionRaw: number): Promise<FactoryInfo | undefined>;
+//# sourceMappingURL=factory_info.d.ts.map

package/dist/hid/factory_info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory_info.d.ts","sourceRoot":"","sources":["../../src/hid/factory_info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,kCAAkC;AAClC,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,aAAa,mBAAmB;IAChC,SAAS,eAAe;IACxB,QAAQ,cAAc;IACtB,cAAc,oBAAoB;IAClC,aAAa,mBAAmB;IAChC,cAAc,oBAAoB;IAClC,WAAW,iBAAiB;IAC5B,cAAc,oBAAoB;IAClC,UAAU,gBAAgB;IAC1B,UAAU,gBAAgB;IAC1B,YAAY,kBAAkB;IAC9B,WAAW,iBAAiB;IAC5B,eAAe,qBAAqB;IACpC,gBAAgB,wBAAwB;IACxC,UAAU,iBAAiB;IAC3B,QAAQ,cAAc;IACtB,QAAQ,aAAa;IACrB,WAAW,mBAAmB;IAC9B,sBAAsB,8BAA8B;IACpD,aAAa,mBAAmB;CACjC;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAsB5D,CAAC;AAWF,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,iHAAiH;AACjH,eAAO,MAAM,kBAAkB,EAAE,WAKhC,CAAC;AA4EF;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,WAAW,EACrB,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAmClC"}

package/dist/hid/factory_info.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFactoryInfo = exports.DefaultFactoryInfo = exports.DualsenseColorMap = exports.DualsenseColor = void 0;
+/** Known DualSense body colors */
+var DualsenseColor;
+(function (DualsenseColor) {
+    DualsenseColor["Unknown"] = "Unknown";
+    DualsenseColor["White"] = "White";
+    DualsenseColor["MidnightBlack"] = "Midnight Black";
+    DualsenseColor["CosmicRed"] = "Cosmic Red";
+    DualsenseColor["NovaPink"] = "Nova Pink";
+    DualsenseColor["GalacticPurple"] = "Galactic Purple";
+    DualsenseColor["StarlightBlue"] = "Starlight Blue";
+    DualsenseColor["GreyCamouflage"] = "Grey Camouflage";
+    DualsenseColor["VolcanicRed"] = "Volcanic Red";
+    DualsenseColor["SterlingSilver"] = "Sterling Silver";
+    DualsenseColor["CobaltBlue"] = "Cobalt Blue";
+    DualsenseColor["ChromaTeal"] = "Chroma Teal";
+    DualsenseColor["ChromaIndigo"] = "Chroma Indigo";
+    DualsenseColor["ChromaPearl"] = "Chroma Pearl";
+    DualsenseColor["Anniversary30th"] = "30th Anniversary";
+    DualsenseColor["GodOfWarRagnarok"] = "God of War Ragnarok";
+    DualsenseColor["SpiderMan2"] = "Spider-Man 2";
+    DualsenseColor["AstroBot"] = "Astro Bot";
+    DualsenseColor["Fortnite"] = "Fortnite";
+    DualsenseColor["TheLastOfUs"] = "The Last of Us";
+    DualsenseColor["IconBlueLimitedEdition"] = "Icon Blue Limited Edition";
+    DualsenseColor["GenshinImpact"] = "Genshin Impact";
+})(DualsenseColor = exports.DualsenseColor || (exports.DualsenseColor = {}));
+/** Known DualSense body colors, keyed by the 2-char code from the serial number */
+exports.DualsenseColorMap = {
+    "00": DualsenseColor.White,
+    "01": DualsenseColor.MidnightBlack,
+    "02": DualsenseColor.CosmicRed,
+    "03": DualsenseColor.NovaPink,
+    "04": DualsenseColor.GalacticPurple,
+    "05": DualsenseColor.StarlightBlue,
+    "06": DualsenseColor.GreyCamouflage,
+    "07": DualsenseColor.VolcanicRed,
+    "08": DualsenseColor.SterlingSilver,
+    "09": DualsenseColor.CobaltBlue,
+    "10": DualsenseColor.ChromaTeal,
+    "11": DualsenseColor.ChromaIndigo,
+    "12": DualsenseColor.ChromaPearl,
+    "30": DualsenseColor.Anniversary30th,
+    Z1: DualsenseColor.GodOfWarRagnarok,
+    Z2: DualsenseColor.SpiderMan2,
+    Z3: DualsenseColor.AstroBot,
+    Z4: DualsenseColor.Fortnite,
+    Z6: DualsenseColor.TheLastOfUs,
+    ZB: DualsenseColor.IconBlueLimitedEdition,
+    ZE: DualsenseColor.GenshinImpact,
+};
+/** Board revision names, keyed by the character at serial position 1 */
+const BoardRevisionMap = {
+    "1": "BDM-010",
+    "2": "BDM-020",
+    "3": "BDM-030",
+    "4": "BDM-040",
+    "5": "BDM-050",
+};
+/** Default FactoryInfo used when the test command protocol is unavailable (e.g. Linux Bluetooth via node-hid) */
+exports.DefaultFactoryInfo = {
+    serialNumber: "unknown",
+    colorName: "unknown",
+    colorCode: "??",
+    boardRevision: "unknown",
+};
+/** Feature report IDs for the test command protocol */
+const SEND_REPORT_ID = 0x80;
+const RECV_REPORT_ID = 0x81;
+/** Report size for test command feature reports (report ID + 63 bytes payload) */
+const REPORT_SIZE = 64;
+/** Test command device/action IDs */
+const DEVICE_SYSTEM = 0x01;
+const ACTION_READ_SERIAL = 0x13;
+/** Test command response status values */
+const STATUS_COMPLETE = 0x02;
+/**
+ * Send a test command via Feature Report 0x80 and poll 0x81 for the response.
+ * Returns the result data bytes (after the header), or undefined on failure.
+ */
+async function sendTestCommand(provider, deviceId, actionId, maxAttempts = 20) {
+    // Build the send report: report ID at byte 0, then payload.
+    // The provider handles platform differences (WebHID strips byte 0, adds CRC for BT).
+    const sendBuf = new Uint8Array(REPORT_SIZE).fill(0);
+    sendBuf[0] = SEND_REPORT_ID;
+    sendBuf[1] = deviceId;
+    sendBuf[2] = actionId;
+    await provider.sendFeatureReport(SEND_REPORT_ID, sendBuf);
+    // Poll for response
+    for (let i = 0; i < maxAttempts; i++) {
+        await sleep(50);
+        const response = await provider.readFeatureReport(RECV_REPORT_ID, REPORT_SIZE);
+        if (response.length === 0)
+            continue;
+        // Response layout: [reportId, deviceId, actionId, status, ...data]
+        // Note: node-hid includes the report ID at byte 0; WebHID may not.
+        // Find the actual start based on whether byte 0 is the report ID.
+        const offset = response[0] === RECV_REPORT_ID ? 1 : 0;
+        const respDevice = response[offset];
+        const respAction = response[offset + 1];
+        const respStatus = response[offset + 2];
+        if (respDevice !== deviceId || respAction !== actionId)
+            continue;
+        if (respStatus === STATUS_COMPLETE) {
+            return response.slice(offset + 3);
+        }
+    }
+    return undefined;
+}
+/** Decode a byte array as ASCII, stopping at null terminator */
+function decodeAscii(data, offset, length) {
+    let str = "";
+    for (let i = 0; i < length; i++) {
+        const byte = data[offset + i];
+        if (byte === 0)
+            break;
+        str += String.fromCharCode(byte);
+    }
+    return str;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Read factory info (serial number, body color, board revision) from a connected controller.
+ *
+ * Requires firmware support: hardwareInfo >= 777 and mainFirmwareVersion >= 65655.
+ * Use the values from FirmwareInfo (Feature Report 0x20) to check this gate.
+ *
+ * @param provider The HID provider for the connected controller
+ * @param hardwareInfo Hardware info word from FirmwareInfo
+ * @param mainFwVersionRaw Raw uint32 main firmware version from FirmwareInfo
+ */
+async function readFactoryInfo(provider, hardwareInfo, mainFwVersionRaw) {
+    // Firmware gate check
+    if ((hardwareInfo & 0xffff) < 777 || mainFwVersionRaw < 65655) {
+        return undefined;
+    }
+    try {
+        const result = await sendTestCommand(provider, DEVICE_SYSTEM, ACTION_READ_SERIAL);
+        if (!result)
+            return undefined;
+        const serialNumber = decodeAscii(result, 0, 32);
+        if (serialNumber.length < 6)
+            return undefined;
+        const colorCode = serialNumber.slice(4, 6);
+        const revisionChar = serialNumber.slice(1, 2);
+        const colorName = colorCode in exports.DualsenseColorMap ? exports.DualsenseColorMap[colorCode] : colorCode;
+        const boardRevision = revisionChar in BoardRevisionMap
+            ? BoardRevisionMap[revisionChar]
+            : "unknown";
+        return {
+            serialNumber,
+            colorName,
+            colorCode,
+            boardRevision,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+exports.readFactoryInfo = readFactoryInfo;
+//# sourceMappingURL=factory_info.js.map

package/dist/hid/factory_info.js.map

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