steamworks-ffi-node 0.3.1 → 0.4.1

package/README.md

@@ -11,6 +11,8 @@ A production-ready TypeScript/JavaScript wrapper for the Steamworks SDK using Ko
 
 > 🎉 **NEW: 100% Stats API Coverage** - All 13 Steam statistics functions implemented! [See Documentation](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/STATS_MANAGER.md)
 
+> 🎉 **NEW: 100% Leaderboard API Coverage** - All 7 Steam leaderboard functions implemented! [See Documentation](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/LEADERBOARD_MANAGER.md)
+
 ## 🎯 Features
 
 - **Complete Achievement API**: 100% coverage of Steam Achievement functionality (20/20 functions)
@@ -24,6 +26,11 @@ A production-ready TypeScript/JavaScript wrapper for the Steamworks SDK using Ko
   - ✅ User stats (get/set int/float, average rate tracking)
   - ✅ Friend comparisons (compare stats with friends)
   - ✅ Global statistics (worldwide aggregated data with history)
+- **Complete Leaderboard API**: 100% coverage of Steam Leaderboard functionality (7/7 functions)
+  - ✅ Leaderboard management (find, create, get info)
+  - ✅ Score operations (upload with optional details)
+  - ✅ Entry download (global, friends, specific users)
+  - ✅ UGC integration (attach replays/screenshots to entries)
 - **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!
@@ -52,34 +59,59 @@ npm install steamworks-ffi-node
 ### Basic Usage
 
 ```typescript
-import Steam from 'steamworks-ffi-node';
+import SteamworksSDK from 'steamworks-ffi-node';
 
 // Initialize Steam connection
-const steam = Steam.getInstance();
+const steam = new SteamworksSDK();
 const initialized = steam.init({ appId: 480 }); // Your Steam App ID
 
 if (initialized) {
   // Get achievements from Steam servers
-  const achievements = await steam.getAllAchievements();
+  const achievements = await steam.achievements.getAllAchievements();
   console.log('Steam achievements:', achievements);
   
   // Unlock achievement (permanent in Steam!)
-  await steam.unlockAchievement('ACH_WIN_ONE_GAME');
+  await steam.achievements.unlockAchievement('ACH_WIN_ONE_GAME');
   
   // Check unlock status from Steam
-  const isUnlocked = await steam.isAchievementUnlocked('ACH_WIN_ONE_GAME');
+  const isUnlocked = await steam.achievements.isAchievementUnlocked('ACH_WIN_ONE_GAME');
   console.log('Achievement unlocked:', isUnlocked);
   
   // Track user statistics
-  const kills = await steam.getStatInt('total_kills') || 0;
-  await steam.setStatInt('total_kills', kills + 1);
+  const kills = await steam.stats.getStatInt('total_kills') || 0;
+  await steam.stats.setStatInt('total_kills', kills + 1);
   
   // Get global statistics
-  await steam.requestGlobalStats(7);
+  await steam.stats.requestGlobalStats(7);
   await new Promise(resolve => setTimeout(resolve, 2000));
   steam.runCallbacks();
-  const globalKills = await steam.getGlobalStatInt('global.total_kills');
+  const globalKills = await steam.stats.getGlobalStatInt('global.total_kills');
   console.log('Total kills worldwide:', globalKills);
+  
+  // Work with leaderboards
+  const leaderboard = await steam.leaderboards.findOrCreateLeaderboard(
+    'HighScores',
+    1, // Descending (higher is better)
+    0  // Numeric display
+  );
+  
+  if (leaderboard) {
+    // Upload score
+    await steam.leaderboards.uploadLeaderboardScore(
+      leaderboard.handle,
+      1000,
+      1  // Keep best score
+    );
+    
+    // Download top 10 scores
+    const topScores = await steam.leaderboards.downloadLeaderboardEntries(
+      leaderboard.handle,
+      0, // Global
+      0,
+      9
+    );
+    console.log('Top 10 scores:', topScores);
+  }
 }
 
 // Cleanup
@@ -89,19 +121,19 @@ steam.shutdown();
 ### JavaScript (CommonJS)
 
 ```javascript
-const Steam = require('steamworks-ffi-node').default;
+const SteamworksSDK = require('steamworks-ffi-node').default;
 
 async function example() {
-  const steam = Steam.getInstance();
+  const steam = new SteamworksSDK();
   
   if (steam.init({ appId: 480 })) {
-    const achievements = await steam.getAllAchievements();
+    const achievements = await steam.achievements.getAllAchievements();
     console.log(`Found ${achievements.length} achievements`);
     
     // Unlock first locked achievement
     const locked = achievements.find(a => !a.unlocked);
     if (locked) {
-      await steam.unlockAchievement(locked.apiName);
+      await steam.achievements.unlockAchievement(locked.apiName);
     }
   }
   
@@ -129,16 +161,16 @@ Complete documentation for all APIs is available in the [docs folder](https://gi
 This library connects directly to the Steam client and Steamworks SDK:
 
 ```javascript
-// Steam API - no mocking!
-const steam = Steam.getInstance();
+// Steamworks API
+const steam = new SteamworksSDK();
 steam.init({ appId: 480 }); // Connects to actual Steam
 
 // Live achievements from Steam servers
-const achievements = await steam.getAllAchievements();
+const achievements = await steam.achievements.getAllAchievements();
 console.log(achievements); // Achievement data from your Steam app
 
 // Permanent achievement unlock in Steam
-await steam.unlockAchievement('YOUR_ACHIEVEMENT');
+await steam.achievements.unlockAchievement('YOUR_ACHIEVEMENT');
 // ^ This shows up in Steam overlay and is saved permanently
 ```
 
@@ -156,10 +188,10 @@ For Electron applications, use it in your main process:
 ```typescript
 // main.ts
 import { app } from 'electron';
-import Steam from 'steamworks-ffi-node';
+import SteamworksSDK from 'steamworks-ffi-node';
 
 app.whenReady().then(() => {
-  const steam = Steam.getInstance();
+  const steam = new SteamworksSDK();
   
   if (steam.init({ appId: YOUR_STEAM_APP_ID })) {
     console.log('Steam initialized in Electron!');
@@ -170,7 +202,8 @@ app.whenReady().then(() => {
 });
 
 app.on('before-quit', () => {
-  Steam.getInstance().shutdown();
+  const steam = new SteamworksSDK();
+  steam.shutdown();
 });
 ```
 

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import SteamworksSDK from './steam';
-import { SteamAchievement, SteamInitOptions, SteamStatus, AchievementProgressLimits, UserAchievement, AchievementGlobalStats, AchievementWithIcon, SteamStat, GlobalStat, GlobalStatHistory, UserStat } from './types';
-export { SteamAchievement, SteamInitOptions, SteamStatus, AchievementProgressLimits, UserAchievement, AchievementGlobalStats, AchievementWithIcon, SteamStat, GlobalStat, GlobalStatHistory, UserStat };
+export { SteamAchievementManager } from './internal/SteamAchievementManager';
+export { SteamStatsManager } from './internal/SteamStatsManager';
+export { SteamLeaderboardManager } from './internal/SteamLeaderboardManager';
+export * from './types';
 export default SteamworksSDK;
-export { SteamworksSDK as Steam };
 //# 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;AACpC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,QAAQ,EACT,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,QAAQ,EACT,CAAC;AAGF,eAAe,aAAa,CAAC;AAG7B,OAAO,EAAE,aAAa,IAAI,KAAK,EAAE,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;AAG7E,cAAc,SAAS,CAAC;AAGxB,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -1,11 +1,33 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Steam = void 0;
+exports.SteamLeaderboardManager = exports.SteamStatsManager = exports.SteamAchievementManager = void 0;
 const steam_1 = __importDefault(require("./steam"));
-exports.Steam = steam_1.default;
+// Export manager classes for advanced usage
+var SteamAchievementManager_1 = require("./internal/SteamAchievementManager");
+Object.defineProperty(exports, "SteamAchievementManager", { enumerable: true, get: function () { return SteamAchievementManager_1.SteamAchievementManager; } });
+var SteamStatsManager_1 = require("./internal/SteamStatsManager");
+Object.defineProperty(exports, "SteamStatsManager", { enumerable: true, get: function () { return SteamStatsManager_1.SteamStatsManager; } });
+var SteamLeaderboardManager_1 = require("./internal/SteamLeaderboardManager");
+Object.defineProperty(exports, "SteamLeaderboardManager", { enumerable: true, get: function () { return SteamLeaderboardManager_1.SteamLeaderboardManager; } });
+// Export all types from organized structure
+__exportStar(require("./types"), exports);
 // Export main Steam class
 exports.default = steam_1.default;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,oDAAoC;AAkCV,gBAlCnB,eAAa,CAkCW;AAJ/B,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;AAEhC,4CAA4C;AAC5C,0CAAwB;AAExB,0BAA0B;AAC1B,kBAAe,eAAa,CAAC"}

package/dist/internal/SteamAPICore.d.ts

@@ -19,7 +19,7 @@ import { SteamLibraryLoader } from './SteamLibraryLoader';
  *
  * const success = apiCore.init({ appId: 480 });
  * if (success) {
- *   console.log('Steam API initialized!');
+ *   console.log('[Steamworks] Steam API initialized!');
  *   // Use Steam features...
  *   apiCore.shutdown();
  * }
@@ -36,6 +36,8 @@ export declare class SteamAPICore {
     private userStatsInterface;
     /** Pointer to the ISteamUser interface */
     private userInterface;
+    /** Pointer to the ISteamUtils interface */
+    private utilsInterface;
     /**
      * Creates a new SteamAPICore instance
      *
@@ -56,9 +58,9 @@ export declare class SteamAPICore {
      * ```typescript
      * const success = apiCore.init({ appId: 480 });
      * if (success) {
-     *   console.log('Connected to Steam for App ID:', 480);
+     *   console.log('[Steamworks] Connected to Steam for App ID:', 480);
      * } else {
-     *   console.error('Failed to initialize Steam API');
+     *   console.error('[Steamworks] Failed to initialize Steam API');
      * }
      * ```
      *
@@ -114,9 +116,9 @@ export declare class SteamAPICore {
      * @example
      * ```typescript
      * const status = apiCore.getStatus();
-     * console.log(`Initialized: ${status.initialized}`);
-     * console.log(`App ID: ${status.appId}`);
-     * console.log(`Steam ID: ${status.steamId}`);
+     * console.log(`[Steamworks] Initialized: ${status.initialized}`);
+     * console.log(`[Steamworks] App ID: ${status.appId}`);
+     * console.log(`[Steamworks] Steam ID: ${status.steamId}`);
      * ```
      *
      * @remarks
@@ -160,9 +162,9 @@ export declare class SteamAPICore {
      * @example
      * ```typescript
      * if (apiCore.isSteamRunning()) {
-     *   console.log('Steam client is active');
+     *   console.log('[Steamworks] Steam client is active');
      * } else {
-     *   console.warn('Steam client is not running');
+     *   console.warn('[Steamworks] Steam client is not running');
      * }
      * ```
      *
@@ -184,7 +186,7 @@ export declare class SteamAPICore {
      * @example
      * ```typescript
      * if (!apiCore.isInitialized()) {
-     *   console.error('Cannot perform Steam operations - not initialized');
+     *   console.error('[Steamworks] Cannot perform Steam operations - not initialized');
      *   return;
      * }
      * ```
@@ -232,5 +234,26 @@ export declare class SteamAPICore {
      * - This is a native pointer for use with FFI calls
      */
     getUserInterface(): any;
+    /**
+     * Get the ISteamUtils interface pointer
+     *
+     * Returns the native pointer to the ISteamUtils interface, which is used
+     * for utility operations including API call result checking.
+     *
+     * @returns Pointer to ISteamUtils interface, or null if not initialized
+     *
+     * @example
+     * ```typescript
+     * const utils = apiCore.getUtilsInterface();
+     * if (utils) {
+     *   // Use interface for utility operations
+     * }
+     * ```
+     *
+     * @remarks
+     * - Returns null if Steam API is not initialized
+     * - This is a native pointer for use with FFI calls
+     */
+    getUtilsInterface(): 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;;;;OAIG;gBACS,aAAa,EAAE,kBAAkB;IAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAmExC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,IAAI,IAAI;IAWhB;;;;;;;;;;;;;;;;;;;;;;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;CAGxB"}
+{"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;;;;OAIG;gBACS,aAAa,EAAE,kBAAkB;IAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAyExC;;;;;;;;;;;;;;;;;;;;;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;CAGzB"}

package/dist/internal/SteamAPICore.js

@@ -55,7 +55,7 @@ const path = __importStar(require("path"));
  *
  * const success = apiCore.init({ appId: 480 });
  * if (success) {
- *   console.log('Steam API initialized!');
+ *   console.log('[Steamworks] Steam API initialized!');
  *   // Use Steam features...
  *   apiCore.shutdown();
  * }
@@ -76,6 +76,8 @@ class SteamAPICore {
         this.userStatsInterface = null;
         /** Pointer to the ISteamUser interface */
         this.userInterface = null;
+        /** Pointer to the ISteamUtils interface */
+        this.utilsInterface = null;
         this.libraryLoader = libraryLoader;
     }
     /**
@@ -92,9 +94,9 @@ class SteamAPICore {
      * ```typescript
      * const success = apiCore.init({ appId: 480 });
      * if (success) {
-     *   console.log('Connected to Steam for App ID:', 480);
+     *   console.log('[Steamworks] Connected to Steam for App ID:', 480);
      * } else {
-     *   console.error('Failed to initialize Steam API');
+     *   console.error('[Steamworks] Failed to initialize Steam API');
      * }
      * ```
      *
@@ -144,6 +146,11 @@ class SteamAPICore {
             }
             // Get User interface
             this.userInterface = this.libraryLoader.SteamAPI_SteamUser_v023();
+            // Get Utils interface
+            this.utilsInterface = this.libraryLoader.SteamAPI_SteamUtils_v010();
+            if (!this.utilsInterface || this.utilsInterface === null) {
+                console.warn('[Steamworks] WARNING: Failed to get SteamUtils 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);
@@ -160,9 +167,9 @@ class SteamAPICore {
         catch (error) {
             console.error('[Steamworks] ERROR: Failed to initialize Steam API:', error.message);
             console.error('[Steamworks] Make sure:');
-            console.error('   1. Steam client is running and you\'re logged in');
-            console.error('   2. Steamworks redistributable binaries are available');
-            console.error('   3. App ID is valid and game is in your library');
+            console.error('[Steamworks]    1. Steam client is running and you\'re logged in');
+            console.error('[Steamworks]    2. Steamworks redistributable binaries are available');
+            console.error('[Steamworks]    3. App ID is valid and game is in your library');
             return false;
         }
     }
@@ -195,6 +202,7 @@ class SteamAPICore {
             this.initialized = false;
             this.userStatsInterface = null;
             this.userInterface = null;
+            this.utilsInterface = null;
             console.log('[Steamworks] Steam API shutdown complete');
         }
     }
@@ -209,9 +217,9 @@ class SteamAPICore {
      * @example
      * ```typescript
      * const status = apiCore.getStatus();
-     * console.log(`Initialized: ${status.initialized}`);
-     * console.log(`App ID: ${status.appId}`);
-     * console.log(`Steam ID: ${status.steamId}`);
+     * console.log(`[Steamworks] Initialized: ${status.initialized}`);
+     * console.log(`[Steamworks] App ID: ${status.appId}`);
+     * console.log(`[Steamworks] Steam ID: ${status.steamId}`);
      * ```
      *
      * @remarks
@@ -229,7 +237,7 @@ class SteamAPICore {
                 steamId = steamIdNum.toString();
             }
             catch (error) {
-                console.warn('Failed to get Steam ID:', error.message);
+                console.warn('[Steamworks] Failed to get Steam ID:', error.message);
             }
         }
         return {
@@ -266,7 +274,7 @@ class SteamAPICore {
                 this.libraryLoader.SteamAPI_RunCallbacks();
             }
             catch (error) {
-                console.warn('Warning: Error running Steam callbacks:', error.message);
+                console.warn('[Steamworks] Warning: Error running Steam callbacks:', error.message);
             }
         }
     }
@@ -280,9 +288,9 @@ class SteamAPICore {
      * @example
      * ```typescript
      * if (apiCore.isSteamRunning()) {
-     *   console.log('Steam client is active');
+     *   console.log('[Steamworks] Steam client is active');
      * } else {
-     *   console.warn('Steam client is not running');
+     *   console.warn('[Steamworks] Steam client is not running');
      * }
      * ```
      *
@@ -299,7 +307,7 @@ class SteamAPICore {
                 return this.libraryLoader.SteamAPI_IsSteamRunning();
             }
             catch (error) {
-                console.warn('Warning: Error checking if Steam is running:', error.message);
+                console.warn('[Steamworks] Warning: Error checking if Steam is running:', error.message);
                 return false;
             }
         }
@@ -315,7 +323,7 @@ class SteamAPICore {
      * @example
      * ```typescript
      * if (!apiCore.isInitialized()) {
-     *   console.error('Cannot perform Steam operations - not initialized');
+     *   console.error('[Steamworks] Cannot perform Steam operations - not initialized');
      *   return;
      * }
      * ```
@@ -369,6 +377,29 @@ class SteamAPICore {
     getUserInterface() {
         return this.userInterface;
     }
+    /**
+     * Get the ISteamUtils interface pointer
+     *
+     * Returns the native pointer to the ISteamUtils interface, which is used
+     * for utility operations including API call result checking.
+     *
+     * @returns Pointer to ISteamUtils interface, or null if not initialized
+     *
+     * @example
+     * ```typescript
+     * const utils = apiCore.getUtilsInterface();
+     * if (utils) {
+     *   // Use interface for utility operations
+     * }
+     * ```
+     *
+     * @remarks
+     * - Returns null if Steam API is not initialized
+     * - This is a native pointer for use with FFI calls
+     */
+    getUtilsInterface() {
+        return this.utilsInterface;
+    }
 }
 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/SteamAchievementManager.d.ts

@@ -42,9 +42,9 @@ export declare class SteamAchievementManager {
      * @example
      * ```typescript
      * const achievements = await achievementManager.getAllAchievements();
-     * console.log(`Found ${achievements.length} achievements`);
+     * console.log(`[Steamworks] Found ${achievements.length} achievements`);
      * achievements.forEach(ach => {
-     *   console.log(`${ach.displayName}: ${ach.unlocked ? 'Unlocked' : 'Locked'}`);
+     *   console.log(`[Steamworks] ${ach.displayName}: ${ach.unlocked ? 'Unlocked' : 'Locked'}`);
      * });
      * ```
      *
@@ -74,7 +74,7 @@ export declare class SteamAchievementManager {
      * ```typescript
      * const success = await achievementManager.unlockAchievement('ACH_WIN_ONE_GAME');
      * if (success) {
-     *   console.log('Achievement unlocked!');
+     *   console.log('[Steamworks] Achievement unlocked!');
      * }
      * ```
      *
@@ -131,7 +131,7 @@ export declare class SteamAchievementManager {
      * ```typescript
      * const isUnlocked = await achievementManager.isAchievementUnlocked('ACH_WIN_ONE_GAME');
      * if (isUnlocked) {
-     *   console.log('Player has already won one game');
+     *   console.log('[Steamworks] Player has already won one game');
      * }
      * ```
      *
@@ -156,7 +156,7 @@ export declare class SteamAchievementManager {
      * ```typescript
      * const achievement = await achievementManager.getAchievementByName('ACH_WIN_ONE_GAME');
      * if (achievement) {
-     *   console.log(`${achievement.displayName}: ${achievement.description}`);
+     *   console.log(`[Steamworks] ${achievement.displayName}: ${achievement.description}`);
      * }
      * ```
      *
@@ -179,7 +179,7 @@ export declare class SteamAchievementManager {
      * @example
      * ```typescript
      * const total = await achievementManager.getTotalAchievementCount();
-     * console.log(`This game has ${total} achievements`);
+     * console.log(`[Steamworks] This game has ${total} achievements`);
      * ```
      *
      * @remarks
@@ -201,7 +201,7 @@ export declare class SteamAchievementManager {
      * ```typescript
      * const total = await achievementManager.getTotalAchievementCount();
      * const unlocked = await achievementManager.getUnlockedAchievementCount();
-     * console.log(`Progress: ${unlocked}/${total} (${(unlocked/total*100).toFixed(1)}%)`);
+     * console.log(`[Steamworks] Progress: ${unlocked}/${total} (${(unlocked/total*100).toFixed(1)}%)`);
      * ```
      *
      * @remarks
@@ -226,7 +226,7 @@ export declare class SteamAchievementManager {
      * const iconHandle = await achievementManager.getAchievementIcon('ACH_WIN_ONE_GAME');
      * if (iconHandle > 0) {
      *   // Use ISteamUtils::GetImageRGBA() to get actual image data
-     *   console.log(`Icon handle: ${iconHandle}`);
+     *   console.log(`[Steamworks] Icon handle: ${iconHandle}`);
      * }
      * ```
      *
@@ -283,7 +283,7 @@ export declare class SteamAchievementManager {
      * ```typescript
      * const limits = await achievementManager.getAchievementProgressLimitsInt('ACH_WIN_50_GAMES');
      * if (limits) {
-     *   console.log(`Progress range: ${limits.minProgress} to ${limits.maxProgress}`);
+     *   console.log(`[Steamworks] Progress range: ${limits.minProgress} to ${limits.maxProgress}`);
      * }
      * ```
      *
@@ -310,7 +310,7 @@ export declare class SteamAchievementManager {
      * ```typescript
      * const limits = await achievementManager.getAchievementProgressLimitsFloat('ACH_TRAVEL_100KM');
      * if (limits) {
-     *   console.log(`Need to travel ${limits.maxProgress}km`);
+     *   console.log(`[Steamworks] Need to travel ${limits.maxProgress}km`);
      * }
      * ```
      *
@@ -383,7 +383,7 @@ export declare class SteamAchievementManager {
      *
      * if (achievement && achievement.unlocked) {
      *   const date = new Date(achievement.unlockTime * 1000);
-     *   console.log(`Friend unlocked on: ${date.toLocaleDateString()}`);
+     *   console.log(`[Steamworks] Friend unlocked on: ${date.toLocaleDateString()}`);
      * }
      * ```
      *
@@ -416,7 +416,7 @@ export declare class SteamAchievementManager {
      *
      * // Now can get percentages
      * const percent = await achievementManager.getAchievementAchievedPercent('ACH_WIN_ONE_GAME');
-     * console.log(`${percent}% of players have unlocked this achievement`);
+     * console.log(`[Steamworks] ${percent}% of players have unlocked this achievement`);
      * ```
      *
      * @remarks
@@ -443,9 +443,9 @@ export declare class SteamAchievementManager {
      * const percent = await achievementManager.getAchievementAchievedPercent('ACH_WIN_ONE_GAME');
      * if (percent !== null) {
      *   if (percent < 10) {
-     *     console.log(`Rare achievement! Only ${percent.toFixed(2)}% have this`);
+     *     console.log(`[Steamworks] Rare achievement! Only ${percent.toFixed(2)}% have this`);
      *   } else {
-     *     console.log(`Common achievement: ${percent.toFixed(2)}% unlocked`);
+     *     console.log(`[Steamworks] Common achievement: ${percent.toFixed(2)}% unlocked`);
      *   }
      * }
      * ```
@@ -482,7 +482,7 @@ export declare class SteamAchievementManager {
      * const rarest = achievements.reduce((prev, curr) =>
      *   curr.globalUnlockPercentage < prev.globalUnlockPercentage ? curr : prev
      * );
-     * console.log(`Rarest: ${rarest.displayName} (${rarest.globalUnlockPercentage.toFixed(2)}%)`);
+     * console.log(`[Steamworks] Rarest: ${rarest.displayName} (${rarest.globalUnlockPercentage.toFixed(2)}%)`);
      * ```
      *
      * @remarks
@@ -506,9 +506,9 @@ export declare class SteamAchievementManager {
      * ```typescript
      * const mostAchieved = await achievementManager.getMostAchievedAchievementInfo();
      * if (mostAchieved) {
-     *   console.log(`Most achieved: ${mostAchieved.apiName}`);
-     *   console.log(`Unlocked by: ${mostAchieved.percent.toFixed(2)}% of players`);
-     *   console.log(`You ${mostAchieved.unlocked ? 'have' : 'don\'t have'} it`);
+     *   console.log(`[Steamworks] Most achieved: ${mostAchieved.apiName}`);
+     *   console.log(`[Steamworks] Unlocked by: ${mostAchieved.percent.toFixed(2)}% of players`);
+     *   console.log(`[Steamworks] You ${mostAchieved.unlocked ? 'have' : 'don\'t have'} it`);
      * }
      * ```
      *
@@ -554,7 +554,7 @@ export declare class SteamAchievementManager {
      * }
      *
      * top5.forEach((ach, i) => {
-     *   console.log(`${i + 1}. ${ach.apiName}: ${ach.percent.toFixed(2)}%`);
+     *   console.log(`[Steamworks] ${i + 1}. ${ach.apiName}: ${ach.percent.toFixed(2)}%`);
      * });
      * ```
      *
@@ -590,14 +590,14 @@ export declare class SteamAchievementManager {
      * // Get sorted achievements
      * const sorted = await achievementManager.getAllAchievementsSortedByPopularity();
      *
-     * console.log('Most to Least Achieved:');
+     * console.log('[Steamworks] Most to Least Achieved:');
      * sorted.forEach((ach, i) => {
-     *   console.log(`${i + 1}. ${ach.displayName}: ${ach.globalUnlockPercentage.toFixed(2)}%`);
+     *   console.log(`[Steamworks] ${i + 1}. ${ach.displayName}: ${ach.globalUnlockPercentage.toFixed(2)}%`);
      * });
      *
      * // Find rarest achievements
      * const rare = sorted.filter(a => a.globalUnlockPercentage < 5);
-     * console.log(`${rare.length} rare achievements (< 5% unlock rate)`);
+     * console.log(`[Steamworks] ${rare.length} rare achievements (< 5% unlock rate)`);
      * ```
      *
      * @remarks
@@ -662,9 +662,9 @@ export declare class SteamAchievementManager {
      * const achievements = await achievementManager.getAllAchievementsWithIcons();
      *
      * achievements.forEach(ach => {
-     *   console.log(`${ach.displayName}:`);
-     *   console.log(`  Status: ${ach.unlocked ? 'Unlocked' : 'Locked'}`);
-     *   console.log(`  Icon Handle: ${ach.iconHandle}`);
+     *   console.log(`[Steamworks] ${ach.displayName}:`);
+     *   console.log(`[Steamworks]   Status: ${ach.unlocked ? 'Unlocked' : 'Locked'}`);
+     *   console.log(`[Steamworks]   Icon Handle: ${ach.iconHandle}`);
      *
      *   if (ach.iconHandle > 0) {
      *     // Use ISteamUtils::GetImageRGBA() to get actual image