steamworks-ffi-node 0.5.2 → 0.6.0

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!
 
@@ -21,6 +21,8 @@ A production-ready TypeScript/JavaScript wrapper for the Steamworks SDK using Ko
 
 > 🎉 **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)
@@ -58,9 +60,15 @@ 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!
+- **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
@@ -70,18 +78,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
 
@@ -192,6 +207,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
@@ -243,6 +290,7 @@ 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 Manager](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/CLOUD_MANAGER.md)** - Steam Cloud storage operations (14 functions)
 
 ## 🎮 Steamworks Integration
 
@@ -295,66 +343,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'"
@@ -368,16 +383,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/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":"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"}
+{"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"}