steamworks-ffi-node 0.6.10 → 0.7.1

package/docs/README.md

@@ -14,16 +14,19 @@ 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
 steam.overlay.*        // Overlay control operations
 steam.cloud.*          // Cloud storage operations
 steam.workshop.*       // Workshop/UGC operations
+steam.input.*          // Controller input operations
+steam.screenshots.*    // Screenshots 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 +37,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 +45,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 +56,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 +64,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 +73,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 +85,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 +95,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,26 +105,54 @@ 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
+  - **17 Functions** - Complete Steam Cloud (Remote Storage) support
   - File operations (write, read, delete, check existence)
   - File metadata (size, timestamp, persistence status)
   - File listing (count, iterate, get all with details)
   - Quota management (track storage usage and limits)
   - Cloud settings (check/toggle cloud sync for account and app)
+  - Batch writes (atomic multi-file operations)
 
 ### 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
+  - **30 Functions** - Complete Steam Workshop/UGC support
   - Subscription management (subscribe, unsubscribe, list items)
   - Item state & information (download progress, installation info)
   - Query operations (text search, browse, filter Workshop content)
   - Item creation & update (create, upload, manage your Workshop items)
   - Voting & favorites (vote on items, manage favorites)
+  - Item deletion (permanently delete your Workshop items)
+
+### 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
+
+### Screenshots System
+
+- **[Screenshot Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/SCREENSHOT_MANAGER.md)**
+  - **9 Functions** - Complete Steam Screenshots support
+  - Screenshot capture (programmatic and user-triggered)
+  - Add existing images to Steam library (from files or raw RGB data)
+  - Location tagging (geotag screenshots with location names)
+  - User tagging (tag friends who appear in screenshots)
+  - Workshop integration (link screenshots to published items)
+  - Screenshot hooks (intercept F12 to handle screenshots yourself)
+  - VR screenshot support (side-by-side and cubemap formats)
 
 ## 🚀 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,15 +160,18 @@ 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
 - Run Friends Tests: `npm run test:friends:js` - Tests all 22 friends functions
-- Run Cloud Tests: `npm run test:cloud:js` - Tests all 14 cloud storage functions
+- Run Cloud Tests: `npm run test:cloud:js` - Tests all 17 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 Workshop Tests: `npm run test:workshop:js` - Tests all 30 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 +179,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 +196,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.10",
+  "version": "0.7.1",
   "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,10 @@
     "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:screenshots:js": "node tests/js/test-screenshots.js",
     "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 +28,17 @@
     "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",
+    "test:screenshots:ts": "ts-node tests/ts/test-screenshots.ts",
     "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"
   },