steamworks-ffi-node 0.5.1 → 0.5.3

package/README.md

@@ -3,22 +3,26 @@
 
 # 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 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**.
 
 > ✅ **No C++ Compilation Required**: Uses Koffi FFI for seamless installation without Visual Studio Build Tools!
 
+> ⚡ **Latest Steamworks SDK**: Built with Steamworks SDK v1.62 - includes all latest Steam features and improvements!
+
 > 🎉 **NEW: 100% Achievement API Coverage** - All 20 Steam achievement functions implemented! [See Documentation](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/ACHIEVEMENT_MANAGER.md)
 
 > 🎉 **NEW: 100% Stats API Coverage** - All 14 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)
 
-> 🎉 **NEW: Friends API** - 10 essential Steam friends and social functions implemented! [See Documentation](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/FRIENDS_MANAGER.md)
+> 🎉 **NEW: Friends API** - 22 complete Steam friends and social functions implemented! [See Documentation](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/FRIENDS_MANAGER.md)
 
 > 🎉 **NEW: Rich Presence API** - 6 functions for custom status display and friend join functionality! [See Documentation](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/RICH_PRESENCE_MANAGER.md)
 
 > 🎉 **NEW: Overlay API** - 7 functions for complete Steam overlay control! [See Documentation](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/OVERLAY_MANAGER.md)
 
+> 🎉 **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)
+
 ## 🎯 Features
 
 - **Complete Achievement API**: 100% coverage of Steam Achievement functionality (20/20 functions)
@@ -37,11 +41,14 @@ A production-ready TypeScript/JavaScript wrapper for the Steamworks SDK using Ko
   - ✅ Score operations (upload with optional details)
   - ✅ Entry download (global, friends, specific users)
   - ✅ UGC integration (attach replays/screenshots to entries)
-- **Friends & Social API**: Essential Steam friends and social features (10 core functions)
+- **Friends & Social API**: Complete Steam friends and social features (22 functions)
   - ✅ Current user info (persona name, online state)
   - ✅ Friends list management (count, iterate, get all friends)
   - ✅ Friend information (names, states, relationships, Steam levels)
   - ✅ Friend activity (check games being played)
+  - ✅ Friend avatars (small/medium/large avatar handles)
+  - ✅ Friend groups (tags/categories management)
+  - ✅ Coplay tracking (recently played with users)
 - **Rich Presence API**: Complete Rich Presence support (6 functions)
   - ✅ Set/clear rich presence key/value pairs
   - ✅ Query friend rich presence data
@@ -53,6 +60,12 @@ A production-ready TypeScript/JavaScript wrapper for the Steamworks SDK using Ko
   - ✅ Open overlay web browser to URLs
   - ✅ Open store pages with purchase options
   - ✅ Show invite dialogs for multiplayer sessions
+- **Cloud Storage API**: Complete Steam Cloud (Remote Storage) integration (14 functions)
+  - ✅ 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)
 - **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!
@@ -148,13 +161,38 @@ if (initialized) {
     const level = steam.friends.getFriendSteamLevel(friend.steamId);
     console.log(`${name}: Level ${level}, Status: ${state}`);
     
+    // Get avatar handles
+    const smallAvatar = steam.friends.getSmallFriendAvatar(friend.steamId);
+    const mediumAvatar = steam.friends.getMediumFriendAvatar(friend.steamId);
+    if (smallAvatar > 0) {
+      console.log(`  Avatar handles: small=${smallAvatar}, medium=${mediumAvatar}`);
+    }
+    
     // Check if playing a game
     const gameInfo = steam.friends.getFriendGamePlayed(friend.steamId);
-    if (gameInfo.playing) {
-      console.log(`  Playing: ${gameInfo.gameName} (AppID: ${gameInfo.gameId})`);
+    if (gameInfo) {
+      console.log(`  Playing: App ${gameInfo.gameId}`);
     }
   });
   
+  // Check friend groups (tags)
+  const groupCount = steam.friends.getFriendsGroupCount();
+  if (groupCount > 0) {
+    const groupId = steam.friends.getFriendsGroupIDByIndex(0);
+    const groupName = steam.friends.getFriendsGroupName(groupId);
+    const members = steam.friends.getFriendsGroupMembersList(groupId);
+    console.log(`Group "${groupName}" has ${members.length} members`);
+  }
+  
+  // Check recently played with
+  const coplayCount = steam.friends.getCoplayFriendCount();
+  if (coplayCount > 0) {
+    const recentPlayer = steam.friends.getCoplayFriend(0);
+    const playerName = steam.friends.getFriendPersonaName(recentPlayer);
+    const coplayTime = steam.friends.getFriendCoplayTime(recentPlayer);
+    console.log(`Recently played with ${playerName}`);
+  }
+  
   // Set rich presence for custom status
   steam.richPresence.setRichPresence('status', 'In Main Menu');
   steam.richPresence.setRichPresence('connect', '+connect server:27015');
@@ -162,6 +200,38 @@ if (initialized) {
   // Open Steam overlay
   steam.overlay.activateGameOverlay('Friends'); // Open friends list
   steam.overlay.activateGameOverlayToWebPage('https://example.com/wiki'); // Open wiki
+  
+  // Steam Cloud storage operations
+  const saveData = { level: 5, score: 1000, inventory: ['sword', 'shield'] };
+  const buffer = Buffer.from(JSON.stringify(saveData));
+  
+  // Write save file to Steam Cloud
+  const written = steam.cloud.fileWrite('savegame.json', buffer);
+  if (written) {
+    console.log('✅ Save uploaded to Steam Cloud');
+  }
+  
+  // Check cloud quota
+  const quota = steam.cloud.getQuota();
+  console.log(`Cloud storage: ${quota.usedBytes}/${quota.totalBytes} bytes (${quota.percentUsed.toFixed(2)}%)`);
+  
+  // Read save file from Steam Cloud
+  if (steam.cloud.fileExists('savegame.json')) {
+    const result = steam.cloud.fileRead('savegame.json');
+    if (result.success && result.data) {
+      const loadedSave = JSON.parse(result.data.toString());
+      console.log(`Loaded save: Level ${loadedSave.level}, Score ${loadedSave.score}`);
+    }
+  }
+  
+  // List all cloud files
+  const cloudFiles = steam.cloud.getAllFiles();
+  console.log(`Steam Cloud contains ${cloudFiles.length} files:`);
+  cloudFiles.forEach(file => {
+    const kb = (file.size / 1024).toFixed(2);
+    const status = file.persisted ? '☁️' : '⏳';
+    console.log(`${status} ${file.name} - ${kb} KB`);
+  });
 }
 
 // Cleanup
@@ -210,9 +280,10 @@ Complete documentation for all APIs is available in the [docs folder](https://gi
 - **[Achievement Manager](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/ACHIEVEMENT_MANAGER.md)** - Complete achievement system (20 functions)
 - **[Stats Manager](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/STATS_MANAGER.md)** - User and global statistics (14 functions)
 - **[Leaderboard Manager](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/LEADERBOARD_MANAGER.md)** - Leaderboard operations (7 functions)
-- **[Friends Manager](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/FRIENDS_MANAGER.md)** - Friends and social features (10 functions)
+- **[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 Manager](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/CLOUD_MANAGER.md)** - Steam Cloud storage operations (14 functions)
 
 ## 🎮 Steamworks Integration
 
@@ -316,6 +387,8 @@ This ensures native libraries work correctly in packaged Electron apps!
 - ✅ **macOS**: Included (libsteam_api.dylib)
 - ✅ **Linux**: Included (libsteam_api.so)
 
+**Steamworks SDK Version**: v1.62 (Latest)
+
 All redistributable binaries are included in the package - no manual SDK download required!
 
 ## 🔧 Troubleshooting

package/dist/internal/SteamAPICore.d.ts

@@ -40,6 +40,8 @@ export declare class SteamAPICore {
     private utilsInterface;
     /** Pointer to the ISteamFriends interface */
     private friendsInterface;
+    /** Pointer to the ISteamRemoteStorage interface */
+    private remoteStorageInterface;
     /**
      * Creates a new SteamAPICore instance
      *
@@ -278,5 +280,26 @@ export declare class SteamAPICore {
      * - This is a native pointer for use with FFI calls
      */
     getFriendsInterface(): any;
+    /**
+     * Gets the ISteamRemoteStorage interface pointer
+     *
+     * The Remote Storage interface provides access to Steam Cloud file operations,
+     * allowing you to save and sync game data across devices.
+     *
+     * @returns Pointer to ISteamRemoteStorage interface, or null if not initialized
+     *
+     * @example
+     * ```typescript
+     * const remoteStorage = apiCore.getRemoteStorageInterface();
+     * if (remoteStorage) {
+     *   // Use interface for cloud storage operations
+     * }
+     * ```
+     *
+     * @remarks
+     * - Returns null if Steam API is not initialized
+     * - This is a native pointer for use with FFI calls
+     */
+    getRemoteStorageInterface(): 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;;;;OAIG;gBACS,aAAa,EAAE,kBAAkB;IAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IA+ExC;;;;;;;;;;;;;;;;;;;;;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;CAG3B"}
+{"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"}

package/dist/internal/SteamAPICore.js

@@ -80,6 +80,8 @@ class SteamAPICore {
         this.utilsInterface = null;
         /** Pointer to the ISteamFriends interface */
         this.friendsInterface = null;
+        /** Pointer to the ISteamRemoteStorage interface */
+        this.remoteStorageInterface = null;
         this.libraryLoader = libraryLoader;
     }
     /**
@@ -158,6 +160,11 @@ class SteamAPICore {
             if (!this.friendsInterface || this.friendsInterface === null) {
                 console.warn('[Steamworks] WARNING: Failed to get SteamFriends interface');
             }
+            // Get Remote Storage interface
+            this.remoteStorageInterface = this.libraryLoader.SteamAPI_SteamRemoteStorage_v016();
+            if (!this.remoteStorageInterface || this.remoteStorageInterface === null) {
+                console.warn('[Steamworks] WARNING: Failed to get SteamRemoteStorage 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);
@@ -430,6 +437,29 @@ class SteamAPICore {
     getFriendsInterface() {
         return this.friendsInterface;
     }
+    /**
+     * Gets the ISteamRemoteStorage interface pointer
+     *
+     * The Remote Storage interface provides access to Steam Cloud file operations,
+     * allowing you to save and sync game data across devices.
+     *
+     * @returns Pointer to ISteamRemoteStorage interface, or null if not initialized
+     *
+     * @example
+     * ```typescript
+     * const remoteStorage = apiCore.getRemoteStorageInterface();
+     * if (remoteStorage) {
+     *   // Use interface for cloud storage operations
+     * }
+     * ```
+     *
+     * @remarks
+     * - Returns null if Steam API is not initialized
+     * - This is a native pointer for use with FFI calls
+     */
+    getRemoteStorageInterface() {
+        return this.remoteStorageInterface;
+    }
 }
 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAI7B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAa,YAAY;IAsBvB;;;;OAIG;IACH,YAAY,aAAiC;QAvB7C,8DAA8D;QACtD,gBAAW,GAAY,KAAK,CAAC;QAErC,4CAA4C;QACpC,UAAK,GAAW,CAAC,CAAC;QAE1B,+CAA+C;QACvC,uBAAkB,GAAQ,IAAI,CAAC;QAEvC,0CAA0C;QAClC,kBAAa,GAAQ,IAAI,CAAC;QAElC,2CAA2C;QACnC,mBAAc,GAAQ,IAAI,CAAC;QAEnC,6CAA6C;QACrC,qBAAgB,GAAQ,IAAI,CAAC;QAQnC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,IAAI,CAAC,OAAyB;QAC5B,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAE3B,kCAAkC;YAClC,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YAE/C,uDAAuD;YACvD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,iBAAiB,CAAC,CAAC;YAClE,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAEvD,OAAO,CAAC,GAAG,CAAC,mDAAmD,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAE7E,mBAAmB;YACnB,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YAE1B,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;YAEtD,uBAAuB;YACvB,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC;YAEtD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;YACtG,CAAC;YAED,4BAA4B;YAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,uBAAuB,EAAE,CAAC;YAClE,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;YACnF,CAAC;YAED,0BAA0B;YAC1B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,aAAa,CAAC,4BAA4B,EAAE,CAAC;YAC5E,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;gBACjE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC5D,CAAC;YAED,qBAAqB;YACrB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,uBAAuB,EAAE,CAAC;YAElE,sBAAsB;YACtB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,wBAAwB,EAAE,CAAC;YACpE,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;gBACzD,OAAO,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;YAC3E,CAAC;YAED,wBAAwB;YACxB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC,0BAA0B,EAAE,CAAC;YACxE,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;gBAC7D,OAAO,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;YAC7E,CAAC;YAED,2CAA2C;YAC3C,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;YACnE,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,4CAA4C,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;YAEnH,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;YAC3F,CAAC;YAED,oDAAoD;YACpD,IAAI,CAAC,YAAY,EAAE,CAAC;YAEpB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,+CAA+C,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAEzE,OAAO,IAAI,CAAC;QAEd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,qDAAqD,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YAC/F,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACzC,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;YAClF,OAAO,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;YACtF,OAAO,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;YAChF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ;QACN,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;YACvD,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC;YACvC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YACzB,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS;QACP,IAAI,OAAO,GAAG,GAAG,CAAC;QAElB,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YAC1E,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,8BAA8B,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBACzF,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;YAClC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY;QACV,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC;gBACH,IAAI,CAAC,aAAa,CAAC,qBAAqB,EAAE,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,sDAAsD,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACjG,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,cAAc;QACZ,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,aAAa,CAAC,uBAAuB,EAAE,CAAC;YACtD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,2DAA2D,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;gBACpG,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,qBAAqB;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;CACF;AApZD,oCAoZC"}
+{"version":3,"file":"SteamAPICore.js","sourceRoot":"","sources":["../../src/internal/SteamAPICore.ts"],"names":[],"mappings":"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"}

package/dist/internal/SteamCloudManager.d.ts

@@ -0,0 +1,319 @@
+import { SteamLibraryLoader } from './SteamLibraryLoader';
+import { SteamAPICore } from './SteamAPICore';
+import { CloudFileInfo, CloudQuota, CloudFileReadResult } from '../types';
+/**
+ * Manager for Steam Cloud / Remote Storage operations
+ *
+ * The SteamCloudManager provides comprehensive access to Steam's cloud storage system,
+ * allowing you to save and synchronize game data across multiple devices.
+ *
+ * Key Features:
+ * - File operations (read, write, delete, check existence)
+ * - Quota management (check available space)
+ * - File iteration and metadata retrieval
+ * - Automatic synchronization across devices
+ * - Platform-specific sync control
+ *
+ * File Constraints:
+ * - Max file size: 100MB per write, 200MB total
+ * - Filenames are case-insensitive (converted to lowercase)
+ * - Max filename length: 260 characters
+ *
+ * @remarks
+ * All methods require the Steam API to be initialized and cloud to be enabled.
+ * Files are automatically synced when Steam is running and connected.
+ *
+ * @example Basic file operations
+ * ```typescript
+ * const steam = SteamworksSDK.getInstance();
+ * steam.init({ appId: 480 });
+ *
+ * // Write a save file
+ * const saveData = Buffer.from(JSON.stringify({ level: 5, score: 1000 }));
+ * const written = steam.cloud.fileWrite('savegame.json', saveData);
+ *
+ * // Read it back
+ * const result = steam.cloud.fileRead('savegame.json');
+ * if (result.success) {
+ *   const data = JSON.parse(result.data.toString());
+ *   console.log(`Level: ${data.level}, Score: ${data.score}`);
+ * }
+ *
+ * // Check quota
+ * const quota = steam.cloud.getQuota();
+ * console.log(`Using ${quota.percentUsed}% of cloud storage`);
+ * ```
+ *
+ * @example List all cloud files
+ * ```typescript
+ * const files = steam.cloud.getAllFiles();
+ * files.forEach(file => {
+ *   console.log(`${file.name}: ${file.size} bytes, modified ${new Date(file.timestamp * 1000)}`);
+ * });
+ * ```
+ *
+ * @see {@link https://partner.steamgames.com/doc/api/ISteamRemoteStorage ISteamRemoteStorage Documentation}
+ */
+export declare class SteamCloudManager {
+    /** Steam library loader for FFI function calls */
+    private libraryLoader;
+    /** Steam API core for initialization and callback management */
+    private apiCore;
+    /**
+     * Creates a new SteamCloudManager instance
+     *
+     * @param libraryLoader - The Steam library loader for FFI calls
+     * @param apiCore - The Steam API core for lifecycle management
+     */
+    constructor(libraryLoader: SteamLibraryLoader, apiCore: SteamAPICore);
+    /**
+     * Writes a file to Steam Cloud
+     *
+     * @param filename - The name of the file to write (will be converted to lowercase)
+     * @param data - The data to write as a Buffer
+     * @returns True if the write was successful, false otherwise
+     *
+     * @remarks
+     * - Files are limited to 100MB per write and 200MB total
+     * - Filenames are automatically converted to lowercase
+     * - File is queued for upload when Steam is connected
+     * - Overwrites existing file with same name
+     *
+     * @example
+     * ```typescript
+     * const saveData = Buffer.from(JSON.stringify({ level: 5 }));
+     * const success = steam.cloud.fileWrite('savegame.json', saveData);
+     * if (success) {
+     *   console.log('Save file written to cloud');
+     * }
+     * ```
+     */
+    fileWrite(filename: string, data: Buffer): boolean;
+    /**
+     * Reads a file from Steam Cloud
+     *
+     * @param filename - The name of the file to read
+     * @returns CloudFileReadResult with success status and data
+     *
+     * @remarks
+     * - File must exist in cloud storage
+     * - Returns the complete file contents as a Buffer
+     * - Data can be converted to string or parsed as JSON
+     *
+     * @example
+     * ```typescript
+     * const result = steam.cloud.fileRead('savegame.json');
+     * if (result.success && result.data) {
+     *   const saveData = JSON.parse(result.data.toString());
+     *   console.log('Loaded save:', saveData);
+     * }
+     * ```
+     */
+    fileRead(filename: string): CloudFileReadResult;
+    /**
+     * Checks if a file exists in Steam Cloud
+     *
+     * @param filename - The name of the file to check
+     * @returns True if the file exists, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (steam.cloud.fileExists('savegame.json')) {
+     *   console.log('Save file found in cloud');
+     * }
+     * ```
+     */
+    fileExists(filename: string): boolean;
+    /**
+     * Deletes a file from Steam Cloud
+     *
+     * @param filename - The name of the file to delete
+     * @returns True if the file was deleted, false otherwise
+     *
+     * @remarks
+     * - File is removed from cloud storage
+     * - Deletion is synchronized across all devices
+     * - Returns true even if file doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const deleted = steam.cloud.fileDelete('old_save.json');
+     * if (deleted) {
+     *   console.log('Save file deleted from cloud');
+     * }
+     * ```
+     */
+    fileDelete(filename: string): boolean;
+    /**
+     * Gets the size of a file in Steam Cloud
+     *
+     * @param filename - The name of the file
+     * @returns File size in bytes, or 0 if file doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const size = steam.cloud.getFileSize('savegame.json');
+     * console.log(`Save file is ${size} bytes`);
+     * ```
+     */
+    getFileSize(filename: string): number;
+    /**
+     * Gets the last modified timestamp of a file
+     *
+     * @param filename - The name of the file
+     * @returns Unix timestamp of last modification, or 0 if file doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const timestamp = steam.cloud.getFileTimestamp('savegame.json');
+     * const date = new Date(timestamp * 1000);
+     * console.log(`Last saved: ${date.toLocaleString()}`);
+     * ```
+     */
+    getFileTimestamp(filename: string): number;
+    /**
+     * Gets the total number of files in Steam Cloud for this app
+     *
+     * @returns Number of files in cloud storage
+     *
+     * @example
+     * ```typescript
+     * const count = steam.cloud.getFileCount();
+     * console.log(`${count} files in cloud storage`);
+     * ```
+     */
+    getFileCount(): number;
+    /**
+     * Gets the name and size of a file by index
+     *
+     * @param index - The index of the file (0 to GetFileCount()-1)
+     * @returns Object with name and size, or null if index is invalid
+     *
+     * @remarks
+     * Use this with getFileCount() to iterate through all files
+     *
+     * @example
+     * ```typescript
+     * const count = steam.cloud.getFileCount();
+     * for (let i = 0; i < count; i++) {
+     *   const file = steam.cloud.getFileNameAndSize(i);
+     *   if (file) {
+     *     console.log(`${file.name}: ${file.size} bytes`);
+     *   }
+     * }
+     * ```
+     */
+    getFileNameAndSize(index: number): {
+        name: string;
+        size: number;
+    } | null;
+    /**
+     * Gets detailed information about all files in Steam Cloud
+     *
+     * @returns Array of CloudFileInfo objects with complete metadata
+     *
+     * @example
+     * ```typescript
+     * const files = steam.cloud.getAllFiles();
+     * files.forEach(file => {
+     *   const date = new Date(file.timestamp * 1000);
+     *   console.log(`${file.name}:`);
+     *   console.log(`  Size: ${file.size} bytes`);
+     *   console.log(`  Modified: ${date.toLocaleString()}`);
+     *   console.log(`  Persisted: ${file.persisted ? 'Yes' : 'No'}`);
+     * });
+     * ```
+     */
+    getAllFiles(): CloudFileInfo[];
+    /**
+     * Checks if a file is persisted (uploaded) to Steam Cloud
+     *
+     * @param filename - The name of the file to check
+     * @returns True if the file is persisted to cloud, false otherwise
+     *
+     * @remarks
+     * Files may exist locally but not yet be uploaded to the cloud.
+     * This checks if the file has been successfully synced.
+     *
+     * @example
+     * ```typescript
+     * if (steam.cloud.filePersisted('savegame.json')) {
+     *   console.log('Save file is synced to cloud');
+     * } else {
+     *   console.log('Save file is still uploading...');
+     * }
+     * ```
+     */
+    filePersisted(filename: string): boolean;
+    /**
+     * Gets Steam Cloud quota information
+     *
+     * @returns CloudQuota object with total, available, and used bytes
+     *
+     * @remarks
+     * - Total quota varies by app (typically 100MB-1GB)
+     * - Available bytes = total - used
+     * - Quota is per-user, per-app
+     *
+     * @example
+     * ```typescript
+     * const quota = steam.cloud.getQuota();
+     * console.log(`Cloud Storage: ${quota.usedBytes}/${quota.totalBytes} bytes`);
+     * console.log(`${quota.percentUsed.toFixed(1)}% used`);
+     * console.log(`${quota.availableBytes} bytes remaining`);
+     * ```
+     */
+    getQuota(): CloudQuota;
+    /**
+     * Checks if Steam Cloud is enabled for the user's account
+     *
+     * @returns True if cloud is enabled at account level
+     *
+     * @remarks
+     * Users can disable Steam Cloud globally in their Steam settings.
+     * If disabled, file operations will fail.
+     *
+     * @example
+     * ```typescript
+     * if (!steam.cloud.isCloudEnabledForAccount()) {
+     *   console.warn('User has disabled Steam Cloud in their settings');
+     * }
+     * ```
+     */
+    isCloudEnabledForAccount(): boolean;
+    /**
+     * Checks if Steam Cloud is enabled for this specific app
+     *
+     * @returns True if cloud is enabled for this app
+     *
+     * @remarks
+     * Apps can enable/disable cloud storage independently.
+     * Even if account cloud is enabled, app cloud might be disabled.
+     *
+     * @example
+     * ```typescript
+     * if (steam.cloud.isCloudEnabledForApp()) {
+     *   console.log('Steam Cloud is active for this game');
+     * }
+     * ```
+     */
+    isCloudEnabledForApp(): boolean;
+    /**
+     * Enables or disables Steam Cloud for this app
+     *
+     * @param enabled - True to enable cloud, false to disable
+     *
+     * @remarks
+     * - This is a per-app setting
+     * - User must have cloud enabled at account level
+     * - Changes are saved to Steam config
+     *
+     * @example
+     * ```typescript
+     * // Let user toggle cloud saves
+     * steam.cloud.setCloudEnabledForApp(userWantsCloudSaves);
+     * ```
+     */
+    setCloudEnabledForApp(enabled: boolean): void;
+}
+//# sourceMappingURL=SteamCloudManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SteamCloudManager.d.ts","sourceRoot":"","sources":["../../src/internal/SteamCloudManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,aAAa,EACb,UAAU,EAEV,mBAAmB,EAGpB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,qBAAa,iBAAiB;IAC5B,kDAAkD;IAClD,OAAO,CAAC,aAAa,CAAqB;IAE1C,gEAAgE;IAChE,OAAO,CAAC,OAAO,CAAe;IAE9B;;;;;OAKG;gBACS,aAAa,EAAE,kBAAkB,EAAE,OAAO,EAAE,YAAY;IAKpE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IA2BlD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IAiD/C;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAkBrC;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAkBrC;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAkBrC;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAkB1C;;;;;;;;;;OAUG;IACH,YAAY,IAAI,MAAM;IAkBtB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA0CxE;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,IAAI,aAAa,EAAE;IAuB9B;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAkBxC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,IAAI,UAAU;IA2CtB;;;;;;;;;;;;;;;OAeG;IACH,wBAAwB,IAAI,OAAO;IAkBnC;;;;;;;;;;;;;;;OAeG;IACH,oBAAoB,IAAI,OAAO;IAkB/B;;;;;;;;;;;;;;;OAeG;IACH,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAgB9C"}