steamworks-ffi-node 0.6.9 → 0.7.0

package/dist/types/input.d.ts

@@ -0,0 +1,252 @@
+/**
+ * Steam Input types
+ *
+ * Types for Steam Input API which provides unified controller support
+ * across Xbox, PlayStation, Nintendo Switch, Steam Controller, and more.
+ */
+/**
+ * Handle for a specific controller device
+ * This handle consistently identifies a controller even across disconnects/reconnects
+ */
+export type InputHandle = bigint;
+/**
+ * Handle for an action set
+ * Action sets group related actions together (e.g., "MenuControls", "GameplayControls")
+ */
+export type InputActionSetHandle = bigint;
+/**
+ * Handle for a digital action (button press)
+ */
+export type InputDigitalActionHandle = bigint;
+/**
+ * Handle for an analog action (joystick, trigger, etc.)
+ */
+export type InputAnalogActionHandle = bigint;
+/**
+ * Constants for Steam Input
+ */
+export declare const STEAM_INPUT: {
+    /** Maximum number of controllers supported */
+    readonly MAX_COUNT: 16;
+    /** Maximum number of analog actions */
+    readonly MAX_ANALOG_ACTIONS: 24;
+    /** Maximum number of digital actions */
+    readonly MAX_DIGITAL_ACTIONS: 256;
+    /** Maximum number of origins for an action */
+    readonly MAX_ORIGINS: 8;
+    /** Maximum number of active action set layers */
+    readonly MAX_ACTIVE_LAYERS: 16;
+    /** Special handle to send commands to all controllers */
+    readonly HANDLE_ALL_CONTROLLERS: bigint;
+    /** Min value for analog action data */
+    readonly MIN_ANALOG_ACTION_DATA: -1;
+    /** Max value for analog action data */
+    readonly MAX_ANALOG_ACTION_DATA: 1;
+};
+/**
+ * Input source modes - describes how an analog action gets its data
+ */
+export declare enum InputSourceMode {
+    None = 0,
+    Dpad = 1,
+    Buttons = 2,
+    FourButtons = 3,
+    AbsoluteMouse = 4,
+    RelativeMouse = 5,
+    JoystickMove = 6,
+    JoystickMouse = 7,
+    JoystickCamera = 8,
+    ScrollWheel = 9,
+    Trigger = 10,
+    TouchMenu = 11,
+    MouseJoystick = 12,
+    MouseRegion = 13,
+    RadialMenu = 14,
+    SingleButton = 15,
+    Switches = 16
+}
+/**
+ * Controller input types
+ * Note: This enum is stable and won't change with Steam updates
+ */
+export declare enum SteamInputType {
+    Unknown = 0,
+    SteamController = 1,
+    XBox360Controller = 2,
+    XBoxOneController = 3,
+    GenericGamepad = 4,
+    PS4Controller = 5,
+    AppleMFiController = 6,
+    AndroidController = 7,
+    SwitchJoyConPair = 8,
+    SwitchJoyConSingle = 9,
+    SwitchProController = 10,
+    MobileTouch = 11,
+    PS3Controller = 12,
+    PS5Controller = 13,
+    SteamDeckController = 14,
+    Count = 15,
+    MaximumPossibleValue = 255
+}
+/**
+ * LED flags for SetLEDColor
+ */
+export declare enum SteamInputLEDFlag {
+    /** Set the color */
+    SetColor = 0,
+    /** Restore the default color */
+    RestoreUserDefault = 1
+}
+/**
+ * Glyph sizes for controller button icons
+ */
+export declare enum SteamInputGlyphSize {
+    Small = 0,
+    Medium = 1,
+    Large = 2,
+    Count = 3
+}
+/**
+ * Glyph style flags for controller button icons
+ */
+export declare enum SteamInputGlyphStyle {
+    /** Use the default glyphs for the controller type */
+    Knockout = 0,
+    /** Black detail/borders on white background */
+    Light = 1,
+    /** White detail/borders on black background */
+    Dark = 2,
+    /** ABXY buttons match base color instead of physical colors */
+    NeutralColorABXY = 16,
+    /** ABXY buttons have solid fill */
+    SolidABXY = 32
+}
+/**
+ * Haptic locations for Steam Controller
+ */
+export declare enum ControllerHapticLocation {
+    Left = 1,
+    Right = 2,
+    Both = 3
+}
+/**
+ * Haptic pad locations for legacy API
+ */
+export declare enum SteamControllerPad {
+    Left = 0,
+    Right = 1
+}
+/**
+ * Configuration enable types
+ */
+export declare enum SteamInputConfigurationEnableType {
+    None = 0,
+    Playstation = 1,
+    Xbox = 2,
+    Generic = 4,
+    Switch = 8
+}
+/**
+ * Digital action data (button state)
+ */
+export interface InputDigitalActionData {
+    /** True if the button is currently pressed */
+    state: boolean;
+    /** True if this action is currently available in the active action set */
+    active: boolean;
+}
+/**
+ * Analog action data (joystick, trigger, etc.)
+ */
+export interface InputAnalogActionData {
+    /** Type of data (joystick, trigger, etc.) */
+    mode: InputSourceMode;
+    /** X-axis value (-1.0 to 1.0) */
+    x: number;
+    /** Y-axis value (-1.0 to 1.0) */
+    y: number;
+    /** True if this action is currently available in the active action set */
+    active: boolean;
+}
+/**
+ * Motion data from controller gyroscope and accelerometer
+ */
+export interface InputMotionData {
+    /** Quaternion X component for absolute rotation */
+    rotQuatX: number;
+    /** Quaternion Y component for absolute rotation */
+    rotQuatY: number;
+    /** Quaternion Z component for absolute rotation */
+    rotQuatZ: number;
+    /** Quaternion W component for absolute rotation */
+    rotQuatW: number;
+    /** Positional acceleration X (right side up is positive) */
+    posAccelX: number;
+    /** Positional acceleration Y (forward side up is positive) */
+    posAccelY: number;
+    /** Positional acceleration Z (sticks up is positive) */
+    posAccelZ: number;
+    /** Angular velocity X (local pitch in degrees/sec) */
+    rotVelX: number;
+    /** Angular velocity Y (local roll in degrees/sec) */
+    rotVelY: number;
+    /** Angular velocity Z (local yaw in degrees/sec) */
+    rotVelZ: number;
+}
+/**
+ * Controller information
+ */
+export interface ControllerInfo {
+    /** Controller handle */
+    handle: InputHandle;
+    /** Controller type */
+    type: SteamInputType;
+    /** Human-readable controller type name */
+    typeName: string;
+    /** Gamepad index if emulating XInput (-1 if not) */
+    gamepadIndex: number;
+}
+/**
+ * Action origin information for displaying button glyphs
+ */
+export interface ActionOriginInfo {
+    /** Path to PNG file for the button glyph */
+    glyphPNG?: string;
+    /** Path to SVG file for the button glyph */
+    glyphSVG?: string;
+    /** Localized string for the button name */
+    localizedString?: string;
+}
+/**
+ * Action set layer information
+ */
+export interface ActionSetLayer {
+    /** Handle for the layer */
+    handle: InputActionSetHandle;
+    /** Name of the layer */
+    name: string;
+}
+/**
+ * Device binding revision
+ */
+export interface DeviceBindingRevision {
+    /** Major version */
+    major: number;
+    /** Minor version */
+    minor: number;
+}
+/**
+ * Input action configuration for generating VDF files
+ */
+export interface InputActionConfig {
+    /** List of action sets */
+    actionSets: Array<{
+        /** Name of the action set */
+        name: string;
+        /** Digital actions (buttons) */
+        digitalActions?: string[];
+        /** Analog actions (sticks, triggers) */
+        analogActions?: string[];
+    }>;
+}
+//# sourceMappingURL=input.d.ts.map

package/dist/types/input.d.ts.map

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

package/dist/types/input.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Steam Input types
+ *
+ * Types for Steam Input API which provides unified controller support
+ * across Xbox, PlayStation, Nintendo Switch, Steam Controller, and more.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SteamInputConfigurationEnableType = exports.SteamControllerPad = exports.ControllerHapticLocation = exports.SteamInputGlyphStyle = exports.SteamInputGlyphSize = exports.SteamInputLEDFlag = exports.SteamInputType = exports.InputSourceMode = exports.STEAM_INPUT = void 0;
+/**
+ * Constants for Steam Input
+ */
+exports.STEAM_INPUT = {
+    /** Maximum number of controllers supported */
+    MAX_COUNT: 16,
+    /** Maximum number of analog actions */
+    MAX_ANALOG_ACTIONS: 24,
+    /** Maximum number of digital actions */
+    MAX_DIGITAL_ACTIONS: 256,
+    /** Maximum number of origins for an action */
+    MAX_ORIGINS: 8,
+    /** Maximum number of active action set layers */
+    MAX_ACTIVE_LAYERS: 16,
+    /** Special handle to send commands to all controllers */
+    HANDLE_ALL_CONTROLLERS: BigInt('0xFFFFFFFFFFFFFFFF'),
+    /** Min value for analog action data */
+    MIN_ANALOG_ACTION_DATA: -1.0,
+    /** Max value for analog action data */
+    MAX_ANALOG_ACTION_DATA: 1.0,
+};
+/**
+ * Input source modes - describes how an analog action gets its data
+ */
+var InputSourceMode;
+(function (InputSourceMode) {
+    InputSourceMode[InputSourceMode["None"] = 0] = "None";
+    InputSourceMode[InputSourceMode["Dpad"] = 1] = "Dpad";
+    InputSourceMode[InputSourceMode["Buttons"] = 2] = "Buttons";
+    InputSourceMode[InputSourceMode["FourButtons"] = 3] = "FourButtons";
+    InputSourceMode[InputSourceMode["AbsoluteMouse"] = 4] = "AbsoluteMouse";
+    InputSourceMode[InputSourceMode["RelativeMouse"] = 5] = "RelativeMouse";
+    InputSourceMode[InputSourceMode["JoystickMove"] = 6] = "JoystickMove";
+    InputSourceMode[InputSourceMode["JoystickMouse"] = 7] = "JoystickMouse";
+    InputSourceMode[InputSourceMode["JoystickCamera"] = 8] = "JoystickCamera";
+    InputSourceMode[InputSourceMode["ScrollWheel"] = 9] = "ScrollWheel";
+    InputSourceMode[InputSourceMode["Trigger"] = 10] = "Trigger";
+    InputSourceMode[InputSourceMode["TouchMenu"] = 11] = "TouchMenu";
+    InputSourceMode[InputSourceMode["MouseJoystick"] = 12] = "MouseJoystick";
+    InputSourceMode[InputSourceMode["MouseRegion"] = 13] = "MouseRegion";
+    InputSourceMode[InputSourceMode["RadialMenu"] = 14] = "RadialMenu";
+    InputSourceMode[InputSourceMode["SingleButton"] = 15] = "SingleButton";
+    InputSourceMode[InputSourceMode["Switches"] = 16] = "Switches";
+})(InputSourceMode || (exports.InputSourceMode = InputSourceMode = {}));
+/**
+ * Controller input types
+ * Note: This enum is stable and won't change with Steam updates
+ */
+var SteamInputType;
+(function (SteamInputType) {
+    SteamInputType[SteamInputType["Unknown"] = 0] = "Unknown";
+    SteamInputType[SteamInputType["SteamController"] = 1] = "SteamController";
+    SteamInputType[SteamInputType["XBox360Controller"] = 2] = "XBox360Controller";
+    SteamInputType[SteamInputType["XBoxOneController"] = 3] = "XBoxOneController";
+    SteamInputType[SteamInputType["GenericGamepad"] = 4] = "GenericGamepad";
+    SteamInputType[SteamInputType["PS4Controller"] = 5] = "PS4Controller";
+    SteamInputType[SteamInputType["AppleMFiController"] = 6] = "AppleMFiController";
+    SteamInputType[SteamInputType["AndroidController"] = 7] = "AndroidController";
+    SteamInputType[SteamInputType["SwitchJoyConPair"] = 8] = "SwitchJoyConPair";
+    SteamInputType[SteamInputType["SwitchJoyConSingle"] = 9] = "SwitchJoyConSingle";
+    SteamInputType[SteamInputType["SwitchProController"] = 10] = "SwitchProController";
+    SteamInputType[SteamInputType["MobileTouch"] = 11] = "MobileTouch";
+    SteamInputType[SteamInputType["PS3Controller"] = 12] = "PS3Controller";
+    SteamInputType[SteamInputType["PS5Controller"] = 13] = "PS5Controller";
+    SteamInputType[SteamInputType["SteamDeckController"] = 14] = "SteamDeckController";
+    SteamInputType[SteamInputType["Count"] = 15] = "Count";
+    SteamInputType[SteamInputType["MaximumPossibleValue"] = 255] = "MaximumPossibleValue";
+})(SteamInputType || (exports.SteamInputType = SteamInputType = {}));
+/**
+ * LED flags for SetLEDColor
+ */
+var SteamInputLEDFlag;
+(function (SteamInputLEDFlag) {
+    /** Set the color */
+    SteamInputLEDFlag[SteamInputLEDFlag["SetColor"] = 0] = "SetColor";
+    /** Restore the default color */
+    SteamInputLEDFlag[SteamInputLEDFlag["RestoreUserDefault"] = 1] = "RestoreUserDefault";
+})(SteamInputLEDFlag || (exports.SteamInputLEDFlag = SteamInputLEDFlag = {}));
+/**
+ * Glyph sizes for controller button icons
+ */
+var SteamInputGlyphSize;
+(function (SteamInputGlyphSize) {
+    SteamInputGlyphSize[SteamInputGlyphSize["Small"] = 0] = "Small";
+    SteamInputGlyphSize[SteamInputGlyphSize["Medium"] = 1] = "Medium";
+    SteamInputGlyphSize[SteamInputGlyphSize["Large"] = 2] = "Large";
+    SteamInputGlyphSize[SteamInputGlyphSize["Count"] = 3] = "Count";
+})(SteamInputGlyphSize || (exports.SteamInputGlyphSize = SteamInputGlyphSize = {}));
+/**
+ * Glyph style flags for controller button icons
+ */
+var SteamInputGlyphStyle;
+(function (SteamInputGlyphStyle) {
+    /** Use the default glyphs for the controller type */
+    SteamInputGlyphStyle[SteamInputGlyphStyle["Knockout"] = 0] = "Knockout";
+    /** Black detail/borders on white background */
+    SteamInputGlyphStyle[SteamInputGlyphStyle["Light"] = 1] = "Light";
+    /** White detail/borders on black background */
+    SteamInputGlyphStyle[SteamInputGlyphStyle["Dark"] = 2] = "Dark";
+    /** ABXY buttons match base color instead of physical colors */
+    SteamInputGlyphStyle[SteamInputGlyphStyle["NeutralColorABXY"] = 16] = "NeutralColorABXY";
+    /** ABXY buttons have solid fill */
+    SteamInputGlyphStyle[SteamInputGlyphStyle["SolidABXY"] = 32] = "SolidABXY";
+})(SteamInputGlyphStyle || (exports.SteamInputGlyphStyle = SteamInputGlyphStyle = {}));
+/**
+ * Haptic locations for Steam Controller
+ */
+var ControllerHapticLocation;
+(function (ControllerHapticLocation) {
+    ControllerHapticLocation[ControllerHapticLocation["Left"] = 1] = "Left";
+    ControllerHapticLocation[ControllerHapticLocation["Right"] = 2] = "Right";
+    ControllerHapticLocation[ControllerHapticLocation["Both"] = 3] = "Both";
+})(ControllerHapticLocation || (exports.ControllerHapticLocation = ControllerHapticLocation = {}));
+/**
+ * Haptic pad locations for legacy API
+ */
+var SteamControllerPad;
+(function (SteamControllerPad) {
+    SteamControllerPad[SteamControllerPad["Left"] = 0] = "Left";
+    SteamControllerPad[SteamControllerPad["Right"] = 1] = "Right";
+})(SteamControllerPad || (exports.SteamControllerPad = SteamControllerPad = {}));
+/**
+ * Configuration enable types
+ */
+var SteamInputConfigurationEnableType;
+(function (SteamInputConfigurationEnableType) {
+    SteamInputConfigurationEnableType[SteamInputConfigurationEnableType["None"] = 0] = "None";
+    SteamInputConfigurationEnableType[SteamInputConfigurationEnableType["Playstation"] = 1] = "Playstation";
+    SteamInputConfigurationEnableType[SteamInputConfigurationEnableType["Xbox"] = 2] = "Xbox";
+    SteamInputConfigurationEnableType[SteamInputConfigurationEnableType["Generic"] = 4] = "Generic";
+    SteamInputConfigurationEnableType[SteamInputConfigurationEnableType["Switch"] = 8] = "Switch";
+})(SteamInputConfigurationEnableType || (exports.SteamInputConfigurationEnableType = SteamInputConfigurationEnableType = {}));
+//# sourceMappingURL=input.js.map

package/dist/types/input.js.map

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

package/docs/README.md

@@ -9,12 +9,12 @@ Steamworks FFI uses a **manager-based architecture** for better organization:
 ```typescript
 import SteamworksSDK from 'steamworks-ffi-node';
 
-const steam = new SteamworksSDK();
+const steam = SteamworksSDK.getInstance();
 steam.init({ appId: 480 });
 
 // Access features through specialized managers
 steam.achievements.*   // Achievement operations
-steam.stats.*          // Statistics operations  
+steam.stats.*          // Statistics operations
 steam.leaderboards.*   // Leaderboard operations
 steam.friends.*        // Friends and social operations
 steam.richPresence.*   // Rich Presence operations
@@ -24,6 +24,7 @@ steam.workshop.*       // Workshop/UGC operations
 ```
 
 This design:
+
 - ✅ **Groups related functions** - Easy to discover all achievement/stats/leaderboard methods
 - ✅ **Clear namespacing** - No naming conflicts
 - ✅ **Better IDE support** - Autocomplete shows relevant methods
@@ -34,6 +35,7 @@ This design:
 ## 📚 Available Documentation
 
 ### Core API
+
 - **[SteamAPICore Documentation](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/STEAM_API_CORE.md)**
   - Initialization and lifecycle management
   - Steam callbacks and event handling
@@ -41,6 +43,7 @@ This design:
   - Platform-specific library loading
 
 ### Achievement System
+
 - **[Achievement Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/ACHIEVEMENT_MANAGER.md)**
   - **20 Functions** - 100% Achievement API coverage
   - Core operations (get, unlock, clear, check status)
@@ -51,6 +54,7 @@ This design:
   - Testing tools (reset stats/achievements)
 
 ### Statistics System
+
 - **[Stats Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/STATS_MANAGER.md)**
   - **14 Functions** - 100% Stats API coverage
   - User stats (get/set int/float, average rate tracking)
@@ -58,6 +62,7 @@ This design:
   - Global statistics (worldwide aggregated data with history)
 
 ### Leaderboard System
+
 - **[Leaderboard Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/LEADERBOARD_MANAGER.md)**
   - **7 Functions** - 100% Leaderboard API coverage
   - Leaderboard management (find, create, get info)
@@ -66,6 +71,7 @@ This design:
   - UGC integration (attach replays/screenshots to entries)
 
 ### Friends & Social System
+
 - **[Friends Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/FRIENDS_MANAGER.md)**
   - **22 Functions** - Complete friends and social features
   - Current user info (get persona name, online status)
@@ -77,6 +83,7 @@ This design:
   - Coplay tracking (recently played with users)
 
 ### Rich Presence System
+
 - **[Rich Presence Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/RICH_PRESENCE_MANAGER.md)**
   - **6 Functions** - Complete Rich Presence support
   - Set/clear rich presence key/value pairs
@@ -86,6 +93,7 @@ This design:
   - Player groups and localization support
 
 ### Overlay System
+
 - **[Overlay Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/OVERLAY_MANAGER.md)**
   - **7 Functions** - Complete overlay control
   - Open overlay to various dialogs (friends, achievements, etc.)
@@ -95,6 +103,7 @@ This design:
   - Show invite dialogs for multiplayer
 
 ### Cloud Storage System
+
 - **[Cloud Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/CLOUD_MANAGER.md)**
   - **14 Functions** - Complete Steam Cloud (Remote Storage) support
   - File operations (write, read, delete, check existence)
@@ -104,6 +113,7 @@ This design:
   - Cloud settings (check/toggle cloud sync for account and app)
 
 ### Workshop System
+
 - **[Workshop Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/WORKSHOP_MANAGER.md)**
   - **29 Functions** - Complete Steam Workshop/UGC support
   - Subscription management (subscribe, unsubscribe, list items)
@@ -112,9 +122,21 @@ This design:
   - Item creation & update (create, upload, manage your Workshop items)
   - Voting & favorites (vote on items, manage favorites)
 
+### Input System
+
+- **[Input Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/INPUT_MANAGER.md)**
+  - **35+ Functions** - Complete Steam Input (controller) support
+  - Controller detection (Xbox, PlayStation, Switch, Steam Controller, Steam Deck)
+  - Action sets and layers (menu controls, gameplay controls, etc.)
+  - Digital actions (buttons) and analog actions (sticks/triggers)
+  - Motion data (gyro, accelerometer for supported controllers)
+  - Haptics (vibration, LED control for DualShock/DualSense)
+  - ⚠️ **Tested with virtual gamepad only** - not yet tested in production projects
+
 ## 🚀 Quick Links
 
 ### Getting Started
+
 - [Installation Guide](https://github.com/ArtyProf/steamworks-ffi-node#installation)
 - [Quick Start Examples](https://github.com/ArtyProf/steamworks-ffi-node#quick-start)
 - [Electron Integration](https://github.com/ArtyProf/steamworks-ffi-node#electron-integration)
@@ -122,6 +144,7 @@ This design:
 ### Testing
 
 **JavaScript Tests** (Production - Uses compiled dist/):
+
 - Run Achievement Tests: `npm run test:achievements:js` - Tests all 20 achievement functions
 - Run Stats Tests: `npm run test:stats:js` - Tests all 14 stats functions
 - Run Leaderboard Tests: `npm run test:leaderboards:js` - Tests all 7 leaderboard functions
@@ -129,8 +152,10 @@ This design:
 - Run Cloud Tests: `npm run test:cloud:js` - Tests all 14 cloud storage functions
 - Run Rich Presence & Overlay Tests: `npm run test:richpresence-overlay:js` - Tests 6 rich presence + 7 overlay functions
 - Run Workshop Tests: `npm run test:workshop:js` - Tests all 29 Workshop/UGC functions
+- Run Input Tests: `npm run test:input-xbox:js` or `npm run test:input-ps4:js` - Tests 35+ input functions with virtual gamepad
 
 **TypeScript Tests** (Development - Direct src/ imports, no rebuild needed):
+
 - Run Achievement Tests: `npm run test:achievements:ts` - With type safety ✨
 - Run Stats Tests: `npm run test:stats:ts` - With type safety ✨
 - Run Leaderboard Tests: `npm run test:leaderboards:ts` - With type safety ✨
@@ -138,12 +163,14 @@ This design:
 - Run Cloud Tests: `npm run test:cloud:ts` - With type safety ✨
 - Run Rich Presence & Overlay Tests: `npm run test:richpresence-overlay:ts` - With type safety ✨
 - Run Workshop Tests: `npm run test:workshop:ts` - With type safety ✨
+- Run Input Tests: `npm run test:input-xbox:ts` or `npm run test:input-ps4:ts` - With type safety ✨
 
 📁 All tests are in `tests/` folder with separate `js/` and `ts/` subfolders.
 
 💡 **Pro tip**: TypeScript tests import directly from `src/` so you can test changes immediately without running `npm run build`!
 
 ### Additional Resources
+
 - [GitHub Repository](https://github.com/ArtyProf/steamworks-ffi-node)
 - [NPM Package](https://www.npmjs.com/package/steamworks-ffi-node)
 - [Report Issues](https://github.com/ArtyProf/steamworks-ffi-node/issues)
@@ -153,6 +180,7 @@ This design:
 ## 📖 Documentation Structure
 
 Each API documentation includes:
+
 - **Overview** - Architecture and design patterns
 - **Quick Reference** - Function categories and counts
 - **Detailed Functions** - Parameters, returns, SDK mappings, examples

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "steamworks-ffi-node",
-  "version": "0.6.9",
+  "version": "0.7.0",
   "description": "Steamworks SDK wrapper using FFI for Node.js/Electron - Full Steam Integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,6 +16,9 @@
     "test:cloud:js": "node tests/js/test-complete-cloud.js",
     "test:workshop:js": "node tests/js/test-workshop.js",
     "test:richpresence-overlay:js": "node tests/js/test-richpresence-overlay.js",
+    "test:input:js": "node tests/js/test-input.js",
+    "test:input-xbox:js": "node tests/js/test-input.js --virtual --type=xbox",
+    "test:input-ps4:js": "node tests/js/test-input.js --virtual --type=ps4",
     "test:core:ts": "ts-node tests/ts/test-core-api.ts",
     "test:achievements:ts": "ts-node tests/ts/test-complete-achievements.ts",
     "test:stats:ts": "ts-node tests/ts/test-complete-stats.ts",
@@ -24,13 +27,16 @@
     "test:cloud:ts": "ts-node tests/ts/test-complete-cloud.ts",
     "test:workshop:ts": "ts-node tests/ts/test-workshop.ts",
     "test:richpresence-overlay:ts": "ts-node tests/ts/test-richpresence-overlay.ts",
+    "test:input:ts": "ts-node tests/ts/test-input.ts",
+    "test:input-xbox:ts": "ts-node tests/ts/test-input.ts --virtual --type=xbox",
+    "test:input-ps4:ts": "ts-node tests/ts/test-input.ts --virtual --type=ps4",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
     "koffi": "^2.8.8"
   },
   "devDependencies": {
-    "@types/node": "^20.19.20",
+    "@types/node": "^24.10.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.0.0"
   },

package/verify-sdk-setup.js

@@ -181,13 +181,13 @@ function testBasicFunctionality() {
   try {
     console.log('Attempting to load steamworks-ffi-node...');
     
-    // Try to require the package
-    const SteamworksSDK = require('./dist/index.js').default || require('./dist/index.js');
+    // Try to require the package (named export is preferred)
+    const { SteamworksSDK } = require('./dist/index.js');
     console.log('✅ Package loaded successfully');
     
     // Try to create instance (this will test SDK loading)
     console.log('Testing SDK initialization...');
-    const steam = new SteamworksSDK();
+    SteamworksSDK.getInstance();
     console.log('✅ SteamworksSDK instance created');
     
     console.log('');