steamworks-ffi-node 0.5.3 → 0.6.1

package/README.md

@@ -3,7 +3,7 @@
 
 # Steamworks FFI - Steamworks SDK Integration
 
-A production-ready TypeScript/JavaScript wrapper for the Steamworks SDK using Koffi FFI, designed for Node.js and Electron applications with **Steamworks SDK v1.62 integration**.
+A TypeScript/JavaScript wrapper for the Steamworks SDK using Koffi FFI, designed for Node.js and Electron applications with **Steamworks SDK v1.62 integration**.
 
 > ✅ **No C++ Compilation Required**: Uses Koffi FFI for seamless installation without Visual Studio Build Tools!
 
@@ -23,6 +23,8 @@ A production-ready TypeScript/JavaScript wrapper for the Steamworks SDK using Ko
 
 > 🎉 **NEW: Cloud Storage API** - 14 functions for complete Steam Cloud (Remote Storage) integration! [See Documentation](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/CLOUD_MANAGER.md)
 
+> 🎉 **NEW: Workshop API** - 25+ functions for complete Steam Workshop/UGC integration! [See Documentation](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/WORKSHOP_MANAGER.md)
+
 ## 🎯 Features
 
 - **Complete Achievement API**: 100% coverage of Steam Achievement functionality (20/20 functions)
@@ -66,9 +68,15 @@ A production-ready TypeScript/JavaScript wrapper for the Steamworks SDK using Ko
   - ✅ 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)
+- **Workshop API**: Complete Steam Workshop/UGC integration (25+ functions)
+  - ✅ Subscription management (subscribe, unsubscribe, list items)
+  - ✅ Item state & information (download progress, installation info)
+  - ✅ Query operations (search, browse, filter Workshop content)
+  - ✅ Item creation & update (create, upload, manage your Workshop items)
+  - ✅ Voting & favorites (vote on items, manage favorites)
 - **Steamworks Integration**: Direct FFI calls to Steamworks C++ SDK
 - **Cross-Platform**: Windows, macOS, and Linux support
-- **Batteries Included**: All Steamworks redistributables bundled - no SDK download needed!
+- **Easy Setup**: Simple installation with clear SDK setup guide
 - **Electron Ready**: Perfect for Electron applications
 - **TypeScript Support**: Complete TypeScript definitions included
 - **No C++ Compilation**: Uses Koffi FFI for seamless installation
@@ -78,18 +86,25 @@ A production-ready TypeScript/JavaScript wrapper for the Steamworks SDK using Ko
 ### Installation
 
 ```bash
-# Install the package - includes all Steam redistributables!
+# Install the package
 npm install steamworks-ffi-node
 ```
 
 ### Setup
 
-1. **Create `steam_appid.txt`** in your project root:
+1. **Download Steamworks SDK** (required separately due to licensing):
+   - Visit [Steamworks Partner site](https://partner.steamgames.com/)
+   - Download the latest Steamworks SDK
+   - Extract and copy `redistributable_bin` folder to your project
+   - See [STEAMWORKS_SDK_SETUP.md](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/STEAMWORKS_SDK_SETUP.md) for detailed instructions
+
+2. **Create `steam_appid.txt` (optional)** in your project root:
    ```bash
    echo "480" > steam_appid.txt  # Use 480 for testing, or your Steam App ID
    ```
+   *Note: You can skip this file and pass the App ID directly to `steam.init(appId)` instead*
 
-2. **Make sure Steam is running** and you're logged in
+3. **Make sure Steam is running** and you're logged in
 
 ### Basic Usage
 
@@ -232,6 +247,70 @@ if (initialized) {
     const status = file.persisted ? '☁️' : '⏳';
     console.log(`${status} ${file.name} - ${kb} KB`);
   });
+  
+  // Steam Workshop operations
+  // Subscribe to a Workshop item
+  const subscribeResult = await steam.workshop.subscribeItem(123456789n);
+  if (subscribeResult.success) {
+    console.log('✅ Subscribed to Workshop item');
+  }
+  
+  // Get all subscribed items
+  const subscribedItems = steam.workshop.getSubscribedItems();
+  console.log(`Subscribed to ${subscribedItems.length} Workshop items`);
+  
+  // Query Workshop items
+  const query = steam.workshop.createQueryAllUGCRequest(
+    0,    // Most popular
+    1,    // Items
+    1,    // Subscribed content
+    1,    // Subscribed items
+    480   // App ID
+  );
+  
+  if (query) {
+    const queryResult = await steam.workshop.sendQueryUGCRequest(query);
+    if (queryResult.success) {
+      console.log(`Found ${queryResult.numResults} Workshop items`);
+      
+      // Get details for each item
+      for (let i = 0; i < queryResult.numResults; i++) {
+        const details = steam.workshop.getQueryUGCResult(query, i);
+        if (details) {
+          console.log(`📦 ${details.title} by ${details.steamIDOwner}`);
+          console.log(`   Score: ${details.score}, Downloads: ${details.numUniqueSubscriptions}`);
+        }
+      }
+    }
+    steam.workshop.releaseQueryUGCRequest(query);
+  }
+  
+  // Check download progress for subscribed items
+  subscribedItems.forEach(itemId => {
+    const state = steam.workshop.getItemState(itemId);
+    const stateFlags = [];
+    if (state & 1) stateFlags.push('Subscribed');
+    if (state & 4) stateFlags.push('Needs Update');
+    if (state & 8) stateFlags.push('Installed');
+    if (state & 16) stateFlags.push('Downloading');
+    
+    console.log(`Item ${itemId}: ${stateFlags.join(', ')}`);
+    
+    if (state & 16) { // If downloading
+      const progress = steam.workshop.getItemDownloadInfo(itemId);
+      if (progress) {
+        const percent = (progress.downloaded / progress.total * 100).toFixed(1);
+        console.log(`  Download: ${percent}% (${progress.downloaded}/${progress.total} bytes)`);
+      }
+    }
+    
+    if (state & 8) { // If installed
+      const info = steam.workshop.getItemInstallInfo(itemId);
+      if (info.success) {
+        console.log(`  Installed at: ${info.folder}`);
+      }
+    }
+  });
 }
 
 // Cleanup
@@ -283,6 +362,8 @@ Complete documentation for all APIs is available in the [docs folder](https://gi
 - **[Friends Manager](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/FRIENDS_MANAGER.md)** - Friends and social features (22 functions)
 - **[Rich Presence Manager](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/RICH_PRESENCE_MANAGER.md)** - Custom status display and join functionality (6 functions)
 - **[Overlay Manager](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/OVERLAY_MANAGER.md)** - Steam overlay control (7 functions)
+- **[Cloud Storage Manager](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/CLOUD_STORAGE_MANAGER.md)** - Steam Cloud file operations (14 functions)
+- **[Workshop Manager](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/WORKSHOP_MANAGER.md)** - Steam Workshop/UGC operations (25+ functions)
 - **[Cloud Manager](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/CLOUD_MANAGER.md)** - Steam Cloud storage operations (14 functions)
 
 ## 🎮 Steamworks Integration
@@ -336,66 +417,33 @@ app.on('before-quit', () => {
 });
 ```
 
-### 📦 Packaging with ASAR
+### 📦 Electron Packaging
 
-When packaging your Electron app with ASAR archives, **native modules must be unpacked**. The library automatically detects ASAR and looks for files in `.asar.unpacked`.
+For Electron applications, the library will automatically detect the Steamworks SDK files in your project directory. No special packaging configuration is needed - just ensure your `steamworks_sdk/redistributable_bin` folder is present in your project.
 
-#### electron-builder Configuration
-
-Add to your `package.json` or `electron-builder.yml`:
-
-```json
-{
-  "build": {
-    "asarUnpack": [
-      "node_modules/steamworks-ffi-node/**/*"
-    ]
-  }
-}
-```
-
-#### electron-forge Configuration
-
-Add to your `forge.config.js`:
-
-```javascript
-module.exports = {
-  packagerConfig: {
-    asar: {
-      unpack: "**/{node_modules/steamworks-ffi-node}/**/*"
-    }
-  }
-};
-```
-
-The library will automatically:
-1. Detect if running inside an ASAR archive
-2. Replace `.asar` with `.asar.unpacked` in the library path
-3. Load the Steamworks SDK from the unpacked directory
-
-This ensures native libraries work correctly in packaged Electron apps!
+The library searches for the SDK in standard locations within your Electron app bundle.
 
 ## 🔧 Requirements
 
 - **Node.js**: 18+ 
 - **Steam Client**: Must be running and logged in
 - **Steam App ID**: Get yours at [Steamworks Partner](https://partner.steamgames.com/)
-- **steam_appid.txt**: Create in your project root with your App ID
+- **steam_appid.txt**: Optional - create in your project root OR pass to `steam.init(appId)`
 
 ### Platform Support
-- ✅ **Windows**: Included (steam_api64.dll / steam_api.dll)
-- ✅ **macOS**: Included (libsteam_api.dylib)
-- ✅ **Linux**: Included (libsteam_api.so)
+- ✅ **Windows**: steam_api64.dll / steam_api.dll
+- ✅ **macOS**: libsteam_api.dylib  
+- ✅ **Linux**: libsteam_api.so
 
 **Steamworks SDK Version**: v1.62 (Latest)
 
-All redistributable binaries are included in the package - no manual SDK download required!
+*Note: You must download and install the SDK redistributables separately as described in the Setup section above.*
 
 ## 🔧 Troubleshooting
 
 ### "SteamAPI_Init failed"
 - ❌ Steam client not running → **Solution**: Start Steam and log in
-- ❌ `steam_appid.txt` missing → **Solution**: Create file in project root with your App ID
+- ❌ No App ID specified → **Solution**: Create `steam_appid.txt` in project root OR pass App ID to `steam.init(appId)`
 - ❌ Invalid App ID → **Solution**: Use 480 for testing, or your registered App ID
 
 ### "Cannot find module 'steamworks-ffi-node'"
@@ -409,16 +457,11 @@ All redistributable binaries are included in the package - no manual SDK downloa
 ### Electron-specific issues
 - ❌ Initialized in renderer → **Solution**: Only initialize in main process
 - ❌ Not cleaning up → **Solution**: Call `shutdown()` in `before-quit` event
-- ❌ "cannot open shared object file: Not a directory" (Linux) → **Solution**: Add `asarUnpack` configuration (see Electron Integration section above)
-- ❌ Native module errors in packaged app → **Solution**: Ensure `steamworks-ffi-node` is in `asarUnpack` list
+- ❌ "Steamworks SDK library not found" in packaged app → **Solution**: Include SDK redistributables in your build (see Electron Packaging section above)
+- ❌ Native module errors in packaged app → **Solution**: Ensure Steamworks SDK files are properly included in your app bundle
 
 ## 📄 License
 
 MIT License - see LICENSE file for details.
 
-### Steamworks SDK Redistributables
-
-This package includes redistributable binaries from the Steamworks SDK (© Valve Corporation).
-These are distributed under the Steamworks SDK Access Agreement in accordance with Section 1.1(b).
-
-See [THIRD_PARTY_LICENSES.md](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/THIRD_PARTY_LICENSES.md) for full details.
+**Note**: This package requires the Steamworks SDK redistributables to be installed separately by users. Users are responsible for complying with Valve's Steamworks SDK Access Agreement when downloading and using the SDK.

package/dist/index.d.ts

@@ -5,6 +5,8 @@ export { SteamLeaderboardManager } from './internal/SteamLeaderboardManager';
 export { SteamFriendsManager } from './internal/SteamFriendsManager';
 export { SteamRichPresenceManager } from './internal/SteamRichPresenceManager';
 export { SteamOverlayManager } from './internal/SteamOverlayManager';
+export { SteamCloudManager } from './internal/SteamCloudManager';
+export { SteamWorkshopManager } from './internal/SteamWorkshopManager';
 export * from './types';
 export default SteamworksSDK;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,SAAS,CAAC;AAGpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,cAAc,SAAS,CAAC;AAGxB,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,SAAS,CAAC;AAGpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,cAAc,SAAS,CAAC;AAGxB,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SteamOverlayManager = exports.SteamRichPresenceManager = exports.SteamFriendsManager = exports.SteamLeaderboardManager = exports.SteamStatsManager = exports.SteamAchievementManager = void 0;
+exports.SteamWorkshopManager = exports.SteamCloudManager = exports.SteamOverlayManager = exports.SteamRichPresenceManager = exports.SteamFriendsManager = exports.SteamLeaderboardManager = exports.SteamStatsManager = exports.SteamAchievementManager = void 0;
 const steam_1 = __importDefault(require("./steam"));
 // Export manager classes for advanced usage
 var SteamAchievementManager_1 = require("./internal/SteamAchievementManager");
@@ -32,6 +32,10 @@ var SteamRichPresenceManager_1 = require("./internal/SteamRichPresenceManager");
 Object.defineProperty(exports, "SteamRichPresenceManager", { enumerable: true, get: function () { return SteamRichPresenceManager_1.SteamRichPresenceManager; } });
 var SteamOverlayManager_1 = require("./internal/SteamOverlayManager");
 Object.defineProperty(exports, "SteamOverlayManager", { enumerable: true, get: function () { return SteamOverlayManager_1.SteamOverlayManager; } });
+var SteamCloudManager_1 = require("./internal/SteamCloudManager");
+Object.defineProperty(exports, "SteamCloudManager", { enumerable: true, get: function () { return SteamCloudManager_1.SteamCloudManager; } });
+var SteamWorkshopManager_1 = require("./internal/SteamWorkshopManager");
+Object.defineProperty(exports, "SteamWorkshopManager", { enumerable: true, get: function () { return SteamWorkshopManager_1.SteamWorkshopManager; } });
 // Export all types from organized structure
 __exportStar(require("./types"), exports);
 // Export main Steam class

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,oDAAoC;AAEpC,4CAA4C;AAC5C,8EAA6E;AAApE,kIAAA,uBAAuB,OAAA;AAChC,kEAAiE;AAAxD,sHAAA,iBAAiB,OAAA;AAC1B,8EAA6E;AAApE,kIAAA,uBAAuB,OAAA;AAChC,sEAAqE;AAA5D,0HAAA,mBAAmB,OAAA;AAC5B,gFAA+E;AAAtE,oIAAA,wBAAwB,OAAA;AACjC,sEAAqE;AAA5D,0HAAA,mBAAmB,OAAA;AAE5B,4CAA4C;AAC5C,0CAAwB;AAExB,0BAA0B;AAC1B,kBAAe,eAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,oDAAoC;AAEpC,4CAA4C;AAC5C,8EAA6E;AAApE,kIAAA,uBAAuB,OAAA;AAChC,kEAAiE;AAAxD,sHAAA,iBAAiB,OAAA;AAC1B,8EAA6E;AAApE,kIAAA,uBAAuB,OAAA;AAChC,sEAAqE;AAA5D,0HAAA,mBAAmB,OAAA;AAC5B,gFAA+E;AAAtE,oIAAA,wBAAwB,OAAA;AACjC,sEAAqE;AAA5D,0HAAA,mBAAmB,OAAA;AAC5B,kEAAiE;AAAxD,sHAAA,iBAAiB,OAAA;AAC1B,wEAAuE;AAA9D,4HAAA,oBAAoB,OAAA;AAE7B,4CAA4C;AAC5C,0CAAwB;AAExB,0BAA0B;AAC1B,kBAAe,eAAa,CAAC"}

package/dist/internal/SteamAPICore.d.ts

@@ -42,6 +42,8 @@ export declare class SteamAPICore {
     private friendsInterface;
     /** Pointer to the ISteamRemoteStorage interface */
     private remoteStorageInterface;
+    /** Pointer to the ISteamUGC interface */
+    private ugcInterface;
     /**
      * Creates a new SteamAPICore instance
      *
@@ -301,5 +303,26 @@ export declare class SteamAPICore {
      * - This is a native pointer for use with FFI calls
      */
     getRemoteStorageInterface(): any;
+    /**
+     * Get the ISteamUGC interface pointer
+     *
+     * Provides access to the Workshop/UGC (User Generated Content) interface for managing
+     * Steam Workshop items.
+     *
+     * @returns Pointer to ISteamUGC interface, or null if not initialized
+     *
+     * @example
+     * ```typescript
+     * const ugc = apiCore.getUGCInterface();
+     * if (ugc) {
+     *   // Use interface for Workshop operations
+     * }
+     * ```
+     *
+     * @remarks
+     * - Returns null if Steam API is not initialized
+     * - This is a native pointer for use with FFI calls
+     */
+    getUGCInterface(): any;
 }
 //# sourceMappingURL=SteamAPICore.d.ts.map

package/dist/internal/SteamAPICore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SteamAPICore.d.ts","sourceRoot":"","sources":["../../src/internal/SteamAPICore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,YAAY;IACvB,kDAAkD;IAClD,OAAO,CAAC,aAAa,CAAqB;IAE1C,8DAA8D;IAC9D,OAAO,CAAC,WAAW,CAAkB;IAErC,4CAA4C;IAC5C,OAAO,CAAC,KAAK,CAAa;IAE1B,+CAA+C;IAC/C,OAAO,CAAC,kBAAkB,CAAa;IAEvC,0CAA0C;IAC1C,OAAO,CAAC,aAAa,CAAa;IAElC,2CAA2C;IAC3C,OAAO,CAAC,cAAc,CAAa;IAEnC,6CAA6C;IAC7C,OAAO,CAAC,gBAAgB,CAAa;IAErC,mDAAmD;IACnD,OAAO,CAAC,sBAAsB,CAAa;IAE3C;;;;OAIG;gBACS,aAAa,EAAE,kBAAkB;IAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAqFxC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,IAAI,IAAI;IAYhB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,IAAI,WAAW;IAmBxB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,IAAI,IAAI;IAUpB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,cAAc,IAAI,OAAO;IAYzB;;;;;;;;;;;;;;OAcG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,qBAAqB,IAAI,GAAG;IAI5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,gBAAgB,IAAI,GAAG;IAIvB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB,IAAI,GAAG;IAIxB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,mBAAmB,IAAI,GAAG;IAI1B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,yBAAyB,IAAI,GAAG;CAGjC"}
+{"version":3,"file":"SteamAPICore.d.ts","sourceRoot":"","sources":["../../src/internal/SteamAPICore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,YAAY;IACvB,kDAAkD;IAClD,OAAO,CAAC,aAAa,CAAqB;IAE1C,8DAA8D;IAC9D,OAAO,CAAC,WAAW,CAAkB;IAErC,4CAA4C;IAC5C,OAAO,CAAC,KAAK,CAAa;IAE1B,+CAA+C;IAC/C,OAAO,CAAC,kBAAkB,CAAa;IAEvC,0CAA0C;IAC1C,OAAO,CAAC,aAAa,CAAa;IAElC,2CAA2C;IAC3C,OAAO,CAAC,cAAc,CAAa;IAEnC,6CAA6C;IAC7C,OAAO,CAAC,gBAAgB,CAAa;IAErC,mDAAmD;IACnD,OAAO,CAAC,sBAAsB,CAAa;IAE3C,yCAAyC;IACzC,OAAO,CAAC,YAAY,CAAa;IAEjC;;;;OAIG;gBACS,aAAa,EAAE,kBAAkB;IAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IA2FxC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,IAAI,IAAI;IAYhB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,IAAI,WAAW;IAmBxB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,IAAI,IAAI;IAUpB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,cAAc,IAAI,OAAO;IAYzB;;;;;;;;;;;;;;OAcG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,qBAAqB,IAAI,GAAG;IAI5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,gBAAgB,IAAI,GAAG;IAIvB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB,IAAI,GAAG;IAIxB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,mBAAmB,IAAI,GAAG;IAI1B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,yBAAyB,IAAI,GAAG;IAIhC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,IAAI,GAAG;CAGvB"}

package/dist/internal/SteamAPICore.js

@@ -82,6 +82,8 @@ class SteamAPICore {
         this.friendsInterface = null;
         /** Pointer to the ISteamRemoteStorage interface */
         this.remoteStorageInterface = null;
+        /** Pointer to the ISteamUGC interface */
+        this.ugcInterface = null;
         this.libraryLoader = libraryLoader;
     }
     /**
@@ -165,6 +167,11 @@ class SteamAPICore {
             if (!this.remoteStorageInterface || this.remoteStorageInterface === null) {
                 console.warn('[Steamworks] WARNING: Failed to get SteamRemoteStorage interface');
             }
+            // Get UGC interface
+            this.ugcInterface = this.libraryLoader.SteamAPI_SteamUGC_v021();
+            if (!this.ugcInterface || this.ugcInterface === null) {
+                console.warn('[Steamworks] WARNING: Failed to get SteamUGC interface');
+            }
             // Request current stats from Steam servers
             console.log('[Steamworks] Requesting current stats from Steam...');
             const statsRequested = this.libraryLoader.SteamAPI_ISteamUserStats_RequestCurrentStats(this.userStatsInterface, 0);
@@ -460,6 +467,29 @@ class SteamAPICore {
     getRemoteStorageInterface() {
         return this.remoteStorageInterface;
     }
+    /**
+     * Get the ISteamUGC interface pointer
+     *
+     * Provides access to the Workshop/UGC (User Generated Content) interface for managing
+     * Steam Workshop items.
+     *
+     * @returns Pointer to ISteamUGC interface, or null if not initialized
+     *
+     * @example
+     * ```typescript
+     * const ugc = apiCore.getUGCInterface();
+     * if (ugc) {
+     *   // Use interface for Workshop operations
+     * }
+     * ```
+     *
+     * @remarks
+     * - Returns null if Steam API is not initialized
+     * - This is a native pointer for use with FFI calls
+     */
+    getUGCInterface() {
+        return this.ugcInterface;
+    }
 }
 exports.SteamAPICore = SteamAPICore;
 //# sourceMappingURL=SteamAPICore.js.map

package/dist/internal/SteamAPICore.js.map

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

package/dist/internal/SteamCallbackPoller.d.ts

@@ -64,5 +64,77 @@ export declare class SteamCallbackPoller {
      * - Logs failure reason using GetAPICallFailureReason()
      */
     poll<T>(callHandle: bigint, resultStruct: any, callbackId: number, maxRetries?: number, delayMs?: number): Promise<T | null>;
+    /**
+     * Decodes a callback result, using custom parsing for packed structs
+     *
+     * Steam SDK uses #pragma pack which causes tight struct packing without natural alignment.
+     * Koffi doesn't support custom pack alignment, so we manually parse bytes for affected callbacks.
+     *
+     * @param callbackId - The callback ID to identify the struct type
+     * @param result - Koffi-allocated result buffer
+     * @param resultStruct - Koffi struct type definition
+     * @returns Decoded result object
+     */
+    private decodeCallbackResult;
+    /**
+     * Manually parses CreateItemResult_t from raw bytes
+     *
+     * Layout: [int32:0-3][uint64:4-11][uint8:12] = 13 bytes, padded to 16
+     * Steam's packed struct has no padding between int32 and uint64
+     *
+     * @param result - Koffi-allocated result buffer
+     * @returns Parsed CreateItemResult_t object
+     */
+    private parseCreateItemResult;
+    /**
+     * Manually parses SubmitItemUpdateResult_t from raw bytes
+     *
+     * Layout: [int32:0-3][bool:4][padding:5-7][uint64:8-15] = 16 bytes
+     * Steam's packed struct has 3 bytes padding after bool to align uint64
+     *
+     * @param result - Koffi-allocated result buffer
+     * @returns Parsed SubmitItemUpdateResult_t object
+     */
+    private parseSubmitItemUpdateResult;
+    /**
+     * Manually parses RemoteStorageSubscribePublishedFileResult_t from raw bytes
+     *
+     * Layout: [int32:0-3][uint64:4-11] = 12 bytes (NO padding!)
+     * Steam's packed struct has no padding between int32 and uint64
+     *
+     * @param result - Koffi-allocated result buffer
+     * @returns Parsed RemoteStorageSubscribePublishedFileResult_t object
+     */
+    private parseSubscribeResult;
+    /**
+     * Manually parses RemoteStorageUnsubscribePublishedFileResult_t from raw bytes
+     *
+     * Layout: [int32:0-3][uint64:4-11] = 12 bytes (NO padding!)
+     * Steam's packed struct has no padding between int32 and uint64
+     *
+     * @param result - Koffi-allocated result buffer
+     * @returns Parsed RemoteStorageUnsubscribePublishedFileResult_t object
+     */
+    private parseUnsubscribeResult;
+    /**
+     * Manually parses SetUserItemVoteResult_t from raw bytes
+     *
+     * Layout: [uint64:0-7][int32:8-11][bool:12] = 13 bytes
+     * Steam's packed struct has no padding after bool
+     *
+     * @param result - Koffi-allocated result buffer
+     * @returns Parsed SetUserItemVoteResult_t object
+     */
+    private parseSetUserItemVoteResult;
+    /**
+     * Manually parses GetUserItemVoteResult_t from raw bytes
+     *
+     * Layout: [uint64:0-7][int32:8-11][bool×3:12-14] = 15 bytes
+     * Steam's packed struct has no padding after bools
+     *
+     * @param result - Koffi-allocated result buffer
+     * @returns Parsed GetUserItemVoteResult_t object
+     */
+    private parseGetUserItemVoteResult;
 }
 //# sourceMappingURL=SteamCallbackPoller.d.ts.map

package/dist/internal/SteamCallbackPoller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SteamCallbackPoller.d.ts","sourceRoot":"","sources":["../../src/internal/SteamCallbackPoller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAe;gBAElB,aAAa,EAAE,kBAAkB,EAAE,OAAO,EAAE,YAAY;IAKpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,IAAI,CAAC,CAAC,EACV,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,GAAG,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAAW,EACvB,OAAO,GAAE,MAAY,GACpB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CAiDrB"}
+{"version":3,"file":"SteamCallbackPoller.d.ts","sourceRoot":"","sources":["../../src/internal/SteamCallbackPoller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAgB9C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAe;gBAElB,aAAa,EAAE,kBAAkB,EAAE,OAAO,EAAE,YAAY;IAKpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,IAAI,CAAC,CAAC,EACV,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,GAAG,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAAW,EACvB,OAAO,GAAE,MAAY,GACpB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAoDpB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,oBAAoB;IA2B5B;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;;;;;;;OAQG;IACH,OAAO,CAAC,2BAA2B;IAWnC;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;;;;;;;OAQG;IACH,OAAO,CAAC,0BAA0B;IAWlC;;;;;;;;OAQG;IACH,OAAO,CAAC,0BAA0B;CAYnC"}

package/dist/internal/SteamCallbackPoller.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SteamCallbackPoller = void 0;
 const koffi = __importStar(require("koffi"));
+const callbackTypes_1 = require("./callbackTypes");
 /**
  * SteamCallbackPoller
  *
@@ -117,11 +118,13 @@ class SteamCallbackPoller {
                 const failedResult = koffi.alloc('bool', 1);
                 const success = this.libraryLoader.SteamAPI_ISteamUtils_GetAPICallResult(utilsInterface, callHandle, result, koffi.sizeof(resultStruct), callbackId, failedResult);
                 if (success && !koffi.decode(failedResult, 'bool')) {
-                    return koffi.decode(result, resultStruct);
+                    // Use custom parsing for packed structs, otherwise use standard Koffi decoding
+                    const decoded = this.decodeCallbackResult(callbackId, result, resultStruct);
+                    return decoded;
                 }
                 else {
                     const failureReason = this.libraryLoader.SteamAPI_ISteamUtils_GetAPICallFailureReason(utilsInterface, callHandle);
-                    console.error(`[Steamworks] API call failed. Reason: ${failureReason}`);
+                    console.error(`[Steamworks] API call failed. Callback ID: ${callbackId}, Struct size: ${koffi.sizeof(resultStruct)}, Reason: ${failureReason}`);
                     return null;
                 }
             }
@@ -129,6 +132,145 @@ class SteamCallbackPoller {
         console.warn(`[Steamworks] API call timed out after ${maxRetries * delayMs}ms`);
         return null;
     }
+    /**
+     * Decodes a callback result, using custom parsing for packed structs
+     *
+     * Steam SDK uses #pragma pack which causes tight struct packing without natural alignment.
+     * Koffi doesn't support custom pack alignment, so we manually parse bytes for affected callbacks.
+     *
+     * @param callbackId - The callback ID to identify the struct type
+     * @param result - Koffi-allocated result buffer
+     * @param resultStruct - Koffi struct type definition
+     * @returns Decoded result object
+     */
+    decodeCallbackResult(callbackId, result, resultStruct) {
+        // Special handling for packed structs - manual byte parsing
+        switch (callbackId) {
+            case callbackTypes_1.K_I_CREATE_ITEM_RESULT:
+                return this.parseCreateItemResult(result);
+            case callbackTypes_1.K_I_SUBMIT_ITEM_UPDATE_RESULT:
+                return this.parseSubmitItemUpdateResult(result);
+            case callbackTypes_1.K_I_REMOTE_STORAGE_SUBSCRIBE_PUBLISHED_FILE_RESULT:
+                return this.parseSubscribeResult(result);
+            case callbackTypes_1.K_I_REMOTE_STORAGE_UNSUBSCRIBE_PUBLISHED_FILE_RESULT:
+                return this.parseUnsubscribeResult(result);
+            case callbackTypes_1.K_I_SET_USER_ITEM_VOTE_RESULT:
+                return this.parseSetUserItemVoteResult(result);
+            case callbackTypes_1.K_I_GET_USER_ITEM_VOTE_RESULT:
+                return this.parseGetUserItemVoteResult(result);
+            default:
+                // Standard Koffi decoding for non-packed structs
+                return koffi.decode(result, resultStruct);
+        }
+    }
+    /**
+     * Manually parses CreateItemResult_t from raw bytes
+     *
+     * Layout: [int32:0-3][uint64:4-11][uint8:12] = 13 bytes, padded to 16
+     * Steam's packed struct has no padding between int32 and uint64
+     *
+     * @param result - Koffi-allocated result buffer
+     * @returns Parsed CreateItemResult_t object
+     */
+    parseCreateItemResult(result) {
+        const rawBytes = koffi.decode(result, koffi.array('uint8', 16));
+        const buffer = Buffer.from(rawBytes);
+        return {
+            m_eResult: buffer.readInt32LE(0),
+            m_nPublishedFileId: buffer.readBigUInt64LE(4),
+            m_bUserNeedsToAcceptWorkshopLegalAgreement: buffer.readUInt8(12) !== 0
+        };
+    }
+    /**
+     * Manually parses SubmitItemUpdateResult_t from raw bytes
+     *
+     * Layout: [int32:0-3][bool:4][padding:5-7][uint64:8-15] = 16 bytes
+     * Steam's packed struct has 3 bytes padding after bool to align uint64
+     *
+     * @param result - Koffi-allocated result buffer
+     * @returns Parsed SubmitItemUpdateResult_t object
+     */
+    parseSubmitItemUpdateResult(result) {
+        const rawBytes = koffi.decode(result, koffi.array('uint8', 16));
+        const buffer = Buffer.from(rawBytes);
+        return {
+            m_eResult: buffer.readInt32LE(0),
+            m_bUserNeedsToAcceptWorkshopLegalAgreement: buffer.readUInt8(4) !== 0,
+            m_nPublishedFileId: buffer.readBigUInt64LE(8)
+        };
+    }
+    /**
+     * Manually parses RemoteStorageSubscribePublishedFileResult_t from raw bytes
+     *
+     * Layout: [int32:0-3][uint64:4-11] = 12 bytes (NO padding!)
+     * Steam's packed struct has no padding between int32 and uint64
+     *
+     * @param result - Koffi-allocated result buffer
+     * @returns Parsed RemoteStorageSubscribePublishedFileResult_t object
+     */
+    parseSubscribeResult(result) {
+        const rawBytes = koffi.decode(result, koffi.array('uint8', 12));
+        const buffer = Buffer.from(rawBytes);
+        return {
+            m_eResult: buffer.readInt32LE(0),
+            m_nPublishedFileId: buffer.readBigUInt64LE(4)
+        };
+    }
+    /**
+     * Manually parses RemoteStorageUnsubscribePublishedFileResult_t from raw bytes
+     *
+     * Layout: [int32:0-3][uint64:4-11] = 12 bytes (NO padding!)
+     * Steam's packed struct has no padding between int32 and uint64
+     *
+     * @param result - Koffi-allocated result buffer
+     * @returns Parsed RemoteStorageUnsubscribePublishedFileResult_t object
+     */
+    parseUnsubscribeResult(result) {
+        const rawBytes = koffi.decode(result, koffi.array('uint8', 12));
+        const buffer = Buffer.from(rawBytes);
+        return {
+            m_eResult: buffer.readInt32LE(0),
+            m_nPublishedFileId: buffer.readBigUInt64LE(4)
+        };
+    }
+    /**
+     * Manually parses SetUserItemVoteResult_t from raw bytes
+     *
+     * Layout: [uint64:0-7][int32:8-11][bool:12] = 13 bytes
+     * Steam's packed struct has no padding after bool
+     *
+     * @param result - Koffi-allocated result buffer
+     * @returns Parsed SetUserItemVoteResult_t object
+     */
+    parseSetUserItemVoteResult(result) {
+        const rawBytes = koffi.decode(result, koffi.array('uint8', 13));
+        const buffer = Buffer.from(rawBytes);
+        return {
+            m_nPublishedFileId: buffer.readBigUInt64LE(0),
+            m_eResult: buffer.readInt32LE(8),
+            m_bVoteUp: buffer.readUInt8(12) !== 0
+        };
+    }
+    /**
+     * Manually parses GetUserItemVoteResult_t from raw bytes
+     *
+     * Layout: [uint64:0-7][int32:8-11][bool×3:12-14] = 15 bytes
+     * Steam's packed struct has no padding after bools
+     *
+     * @param result - Koffi-allocated result buffer
+     * @returns Parsed GetUserItemVoteResult_t object
+     */
+    parseGetUserItemVoteResult(result) {
+        const rawBytes = koffi.decode(result, koffi.array('uint8', 15));
+        const buffer = Buffer.from(rawBytes);
+        return {
+            m_nPublishedFileId: buffer.readBigUInt64LE(0),
+            m_eResult: buffer.readInt32LE(8),
+            m_bVotedUp: buffer.readUInt8(12) !== 0,
+            m_bVotedDown: buffer.readUInt8(13) !== 0,
+            m_bVoteSkipped: buffer.readUInt8(14) !== 0
+        };
+    }
 }
 exports.SteamCallbackPoller = SteamCallbackPoller;
 //# sourceMappingURL=SteamCallbackPoller.js.map