steamworks-ffi-node 0.5.3 → 0.6.1

package/docs/README.md

@@ -0,0 +1,167 @@
+# Steamworks FFI Documentation
+
+Complete API documentation for all Steamworks FFI functionality.
+
+## 🎯 Manager-Based API
+
+Steamworks FFI uses a **manager-based architecture** for better organization:
+
+```typescript
+import SteamworksSDK from 'steamworks-ffi-node';
+
+const steam = new SteamworksSDK();
+steam.init({ appId: 480 });
+
+// Access features through specialized managers
+steam.achievements.*   // Achievement operations
+steam.stats.*          // Statistics operations  
+steam.leaderboards.*   // Leaderboard operations
+steam.friends.*        // Friends and social operations
+steam.richPresence.*   // Rich Presence operations
+steam.overlay.*        // Overlay control operations
+steam.cloud.*          // Cloud storage operations
+steam.workshop.*       // Workshop/UGC operations
+```
+
+This design:
+- ✅ **Groups related functions** - Easy to discover all achievement/stats/leaderboard methods
+- ✅ **Clear namespacing** - No naming conflicts
+- ✅ **Better IDE support** - Autocomplete shows relevant methods
+- ✅ **Logical organization** - Matches Steamworks SDK structure
+
+---
+
+## 📚 Available Documentation
+
+### Core API
+- **[SteamAPICore Documentation](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/STEAM_API_CORE.md)**
+  - Initialization and lifecycle management
+  - Steam callbacks and event handling
+  - Status checking and diagnostics
+  - Platform-specific library loading
+
+### Achievement System
+- **[Achievement Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/ACHIEVEMENT_MANAGER.md)**
+  - **20 Functions** - 100% Achievement API coverage
+  - Core operations (get, unlock, clear, check status)
+  - Visual features (icons, progress notifications)
+  - Progress tracking (get limits for progress bars)
+  - Friend comparisons (see friend achievements)
+  - Global statistics (unlock percentages, popularity sorting)
+  - Testing tools (reset stats/achievements)
+
+### Statistics System
+- **[Stats Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/STATS_MANAGER.md)**
+  - **14 Functions** - 100% Stats API coverage
+  - User stats (get/set int/float, average rate tracking)
+  - Friend comparisons (compare stats with friends)
+  - Global statistics (worldwide aggregated data with history)
+
+### Leaderboard System
+- **[Leaderboard Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/LEADERBOARD_MANAGER.md)**
+  - **7 Functions** - 100% Leaderboard API coverage
+  - Leaderboard management (find, create, get info)
+  - Score operations (upload with optional details)
+  - Entry download (global, friends, specific users)
+  - UGC integration (attach replays/screenshots to entries)
+
+### Friends & Social System
+- **[Friends Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/FRIENDS_MANAGER.md)**
+  - **22 Functions** - Complete friends and social features
+  - Current user info (get persona name, online status)
+  - Friends list management (count, iterate, retrieve all)
+  - Friend information (names, status, relationship types, Steam levels)
+  - Friend activity (check what games friends are playing)
+  - Friend avatars (small/medium/large avatar handles)
+  - Friend groups (manage and query friend tags/categories)
+  - Coplay tracking (recently played with users)
+
+### Rich Presence System
+- **[Rich Presence Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/RICH_PRESENCE_MANAGER.md)**
+  - **6 Functions** - Complete Rich Presence support
+  - Set/clear rich presence key/value pairs
+  - Query friend rich presence data
+  - Display custom status in Steam friends list
+  - Enable friend join functionality
+  - Player groups and localization support
+
+### Overlay System
+- **[Overlay Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/OVERLAY_MANAGER.md)**
+  - **7 Functions** - Complete overlay control
+  - Open overlay to various dialogs (friends, achievements, etc.)
+  - Open overlay to user profiles and stats
+  - Open overlay browser to URLs
+  - Open store pages with purchase options
+  - Show invite dialogs for multiplayer
+
+### Cloud Storage System
+- **[Cloud Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/CLOUD_MANAGER.md)**
+  - **14 Functions** - Complete Steam Cloud (Remote Storage) support
+  - 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)
+
+### Workshop System
+- **[Workshop Manager API](https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/WORKSHOP_MANAGER.md)**
+  - **25+ Functions** - Complete Steam Workshop/UGC support
+  - 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)
+
+## 🚀 Quick Links
+
+### Getting Started
+- [Installation Guide](https://github.com/ArtyProf/steamworks-ffi-node#installation)
+- [Quick Start Examples](https://github.com/ArtyProf/steamworks-ffi-node#quick-start)
+- [Electron Integration](https://github.com/ArtyProf/steamworks-ffi-node#electron-integration)
+
+### Testing
+
+**JavaScript Tests** (Production - Uses compiled dist/):
+- Run Achievement Tests: `npm run test:achievements:js` - Tests all 20 achievement functions
+- Run Stats Tests: `npm run test:stats:js` - Tests all 14 stats functions
+- Run Leaderboard Tests: `npm run test:leaderboards:js` - Tests all 7 leaderboard functions
+- Run Friends Tests: `npm run test:friends:js` - Tests all 22 friends functions
+- Run Cloud Tests: `npm run test:cloud:js` - Tests all 14 cloud storage functions
+- Run Rich Presence & Overlay Tests: `npm run test:richpresence-overlay:js` - Tests 6 rich presence + 7 overlay functions
+- Run Workshop Tests: `npm run test:workshop:js` - Tests all 25+ Workshop/UGC functions
+
+**TypeScript Tests** (Development - Direct src/ imports, no rebuild needed):
+- Run Achievement Tests: `npm run test:achievements:ts` - With type safety ✨
+- Run Stats Tests: `npm run test:stats:ts` - With type safety ✨
+- Run Leaderboard Tests: `npm run test:leaderboards:ts` - With type safety ✨
+- Run Friends Tests: `npm run test:friends:ts` - With type safety ✨
+- Run Cloud Tests: `npm run test:cloud:ts` - With type safety ✨
+- Run Rich Presence & Overlay Tests: `npm run test:richpresence-overlay:ts` - With type safety ✨
+- Run Workshop Tests: `npm run test:workshop:ts` - With type safety ✨
+
+📁 All tests are in `tests/` folder with separate `js/` and `ts/` subfolders.
+
+💡 **Pro tip**: TypeScript tests import directly from `src/` so you can test changes immediately without running `npm run build`!
+
+### Additional Resources
+- [GitHub Repository](https://github.com/ArtyProf/steamworks-ffi-node)
+- [NPM Package](https://www.npmjs.com/package/steamworks-ffi-node)
+- [Report Issues](https://github.com/ArtyProf/steamworks-ffi-node/issues)
+
+---
+
+## 📖 Documentation Structure
+
+Each API documentation includes:
+- **Overview** - Architecture and design patterns
+- **Quick Reference** - Function categories and counts
+- **Detailed Functions** - Parameters, returns, SDK mappings, examples
+- **Configuration** - Steamworks Partner setup instructions
+- **TypeScript Types** - Interface definitions
+- **Complete Examples** - Real-world usage scenarios
+- **Best Practices** - Guidelines and recommendations
+- **Error Handling** - Common issues and solutions
+
+---
+
+**Need help?** Check the [troubleshooting section](https://github.com/ArtyProf/steamworks-ffi-node#troubleshooting) in the main README or [open an issue](https://github.com/ArtyProf/steamworks-ffi-node/issues).

package/docs/STEAMWORKS_SDK_SETUP.md

@@ -0,0 +1,209 @@
+# Steamworks SDK Setup Guide
+
+This guide explains how to properly set up the Steamworks SDK redistributables for use with steamworks-ffi-node, in compliance with Valve's licensing requirements.
+
+## ⚠️ Important Legal Notice
+
+**The Steamworks SDK redistributables cannot be bundled with this package due to Valve's licensing terms.** Users must download and install the Steamworks SDK separately from Valve's official source.
+
+## Quick Setup
+
+### 1. Download Steamworks SDK
+
+1. Visit the [Steamworks Partner site](https://partner.steamgames.com/)
+2. Log in with your Steam account (you need to be a registered Steamworks developer)
+3. Download the latest Steamworks SDK
+4. Extract the downloaded archive
+
+> **Note**: This package was built and tested with Steamworks SDK v1.62. While newer versions should be compatible, v1.62 or later is recommended for optimal compatibility.
+
+### 2. Install SDK Redistributables
+
+Copy the `redistributable_bin` folder from the Steamworks SDK to your project:
+
+```
+your-project/
+├── steamworks_sdk/
+│   └── redistributable_bin/
+│       ├── win64/
+│       │   └── steam_api64.dll
+│       ├── steam_api.dll
+│       ├── osx/
+│       │   └── libsteam_api.dylib
+│       └── linux64/
+│           └── libsteam_api.so
+├── package.json
+└── your-app-files...
+```
+
+### 3. Verify Installation
+
+Run this command to verify the SDK is properly installed:
+
+```bash
+npm run verify-sdk
+```
+
+This will check your steamworks_sdk installation and provide detailed feedback about any missing files or configuration issues.
+
+## Detailed Setup Instructions
+
+### For Game Developers
+
+1. **Get Steamworks Access**
+   - Register as a Steamworks developer at [partner.steamgames.com](https://partner.steamgames.com/)
+   - Complete the registration process and pay the one-time fee if required
+
+2. **Download SDK**
+   - Go to the "Downloads" section in Steamworks Partner
+   - Download the latest Steamworks SDK (typically a .zip file)
+   - Extract the archive to a temporary location
+
+3. **Copy Redistributables**
+   - Navigate to the extracted SDK folder
+   - Find the `redistributable_bin` directory
+   - Copy the entire `redistributable_bin` folder to your project's `steamworks_sdk/` directory
+
+### For Open Source Projects / Contributors
+
+If you're contributing to an open source project that uses steamworks-ffi-node:
+
+1. **SDK Access Required**
+   - You'll need your own Steamworks developer account to download the SDK
+   - The redistributables cannot be shared or bundled due to licensing restrictions
+
+2. **Development Setup**
+   - Download the SDK using your own Steamworks account
+   - Set up the folder structure as described above
+   - Never commit the `steamworks_sdk/` folder to version control
+
+3. **Testing**
+   - Use Spacewar (App ID 480) for testing - it's free and available to all developers
+   - Either create a `steam_appid.txt` file with content `480` OR pass `480` to `steam.init(480)`
+
+## Supported Platforms and Files
+
+### Windows
+- **64-bit**: `steamworks_sdk/redistributable_bin/win64/steam_api64.dll`
+- **32-bit**: `steamworks_sdk/redistributable_bin/steam_api.dll`
+
+### macOS
+- **Universal**: `steamworks_sdk/redistributable_bin/osx/libsteam_api.dylib`
+
+### Linux
+- **64-bit**: `steamworks_sdk/redistributable_bin/linux64/libsteam_api.so`
+
+## Project Structure Examples
+
+### Basic Node.js Project
+```
+my-steam-game/
+├── steamworks_sdk/
+│   └── redistributable_bin/
+│       ├── win64/steam_api64.dll
+│       ├── steam_api.dll
+│       ├── osx/libsteam_api.dylib
+│       └── linux64/libsteam_api.so
+├── package.json
+├── steam_appid.txt
+└── src/
+    └── main.js
+```
+
+### Electron Application
+```
+my-electron-app/
+├── steamworks_sdk/
+│   └── redistributable_bin/
+│       └── [platform files...]
+├── package.json
+├── steam_appid.txt
+├── src/
+│   ├── main.js
+│   └── renderer.js
+└── dist/
+    └── [built app...]
+```
+
+### Monorepo Setup
+```
+my-monorepo/
+├── steamworks_sdk/
+│   └── redistributable_bin/
+│       └── [platform files...]
+├── packages/
+│   ├── game-client/
+│   │   ├── package.json
+│   │   └── src/
+│   └── game-server/
+│       ├── package.json
+│       └── src/
+└── steam_appid.txt
+```
+
+## Troubleshooting
+
+### "Steamworks SDK library not found" Error
+
+This error means the redistributables are not properly installed. Check:
+
+1. ✅ The `steamworks_sdk/redistributable_bin` folder exists in your project root
+2. ✅ Platform-specific libraries are in the correct subfolders
+3. ✅ File permissions allow reading the library files
+4. ✅ You're running from the correct working directory
+
+### "Cannot find function 'SteamAPI_Init'" Error
+
+This usually indicates:
+- Wrong library architecture (32-bit vs 64-bit)
+- Corrupted or incomplete SDK download
+- Incompatible SDK version
+
+**Solution**: Re-download the latest Steamworks SDK and replace the redistributables.
+
+### Permission Issues (macOS/Linux)
+
+If you get permission errors:
+```bash
+# Make library executable
+chmod +x steamworks_sdk/redistributable_bin/osx/libsteam_api.dylib
+chmod +x steamworks_sdk/redistributable_bin/linux64/libsteam_api.so
+```
+
+## Version Compatibility
+
+- **steamworks-ffi-node v0.5.x**: Compatible with Steamworks SDK v1.58+
+- **Always use the latest** Steamworks SDK from Valve for best compatibility
+- **Check release notes** for any breaking changes in new SDK versions
+
+## Legal Compliance
+
+### ✅ Allowed
+- Downloading SDK with your own Steamworks developer account
+- Using redistributables in your own games
+- Distributing your game with embedded redistributables
+
+### ❌ Not Allowed
+- Redistributing SDK files in npm packages
+- Sharing SDK files with non-developers
+- Using SDK without proper Steamworks registration
+
+### 📋 Requirements for Distribution
+- Register as Steamworks developer
+- Agree to Steamworks SDK license
+- Include redistributables only with your shipped game
+
+## Support
+
+If you encounter issues:
+
+1. **Check this guide** for common solutions
+2. **Verify SDK installation** using the verification script above
+3. **Update to latest SDK** from Valve
+4. **Open an issue** at [steamworks-ffi-node GitHub](https://github.com/ArtyProf/steamworks-ffi-node/issues)
+
+For Steamworks SDK licensing questions, contact Valve directly through the Steamworks Partner portal.
+
+---
+
+**Note**: This package is not affiliated with Valve Corporation. Steamworks is a trademark of Valve Corporation.

package/package.json

@@ -1,22 +1,27 @@
 {
   "name": "steamworks-ffi-node",
-  "version": "0.5.3",
+  "version": "0.6.1",
   "description": "Steamworks SDK wrapper using FFI for Node.js/Electron - Full Steam Integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
+    "postinstall": "node postinstall.js",
+    "verify-sdk": "node verify-sdk-setup.js",
+    "test:discord": "node test-discord-integration.js",
     "test:achievements:js": "node tests/js/test-complete-achievements.js",
     "test:stats:js": "node tests/js/test-complete-stats.js",
     "test:leaderboards:js": "node tests/js/test-complete-leaderboards.js",
     "test:friends:js": "node tests/js/test-complete-friends.js",
     "test:cloud:js": "node tests/js/test-complete-cloud.js",
+    "test:workshop:js": "node tests/js/test-workshop.js",
     "test:richpresence-overlay:js": "node tests/js/test-richpresence-overlay.js",
     "test:achievements:ts": "ts-node tests/ts/test-complete-achievements.ts",
     "test:stats:ts": "ts-node tests/ts/test-complete-stats.ts",
     "test:leaderboards:ts": "ts-node tests/ts/test-complete-leaderboards.ts",
     "test:friends:ts": "ts-node tests/ts/test-complete-friends.ts",
     "test:cloud:ts": "ts-node tests/ts/test-complete-cloud.ts",
+    "test:workshop:ts": "ts-node tests/ts/test-workshop.ts",
     "test:richpresence-overlay:ts": "ts-node tests/ts/test-richpresence-overlay.ts",
     "prepublishOnly": "npm run build"
   },
@@ -30,10 +35,11 @@
   },
   "files": [
     "dist/**/*",
-    "steamworks_sdk/redistributable_bin/**/*",
     "README.md",
     "LICENSE",
-    "THIRD_PARTY_LICENSES.md"
+    "docs/STEAMWORKS_SDK_SETUP.md",
+    "verify-sdk-setup.js",
+    "postinstall.js"
   ],
   "keywords": [
     "steam",

package/postinstall.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+/**
+ * Post-installation script for steamworks-ffi-node
+ * 
+ * This script provides guidance to users after package installation
+ * about setting up the Steamworks SDK redistributables.
+ */
+
+console.log('');
+console.log('🎉 steamworks-ffi-node installed successfully!');
+console.log('');
+console.log('📋 Next Steps:');
+console.log('==============');
+console.log('');
+console.log('1. 📥 Download Steamworks SDK redistributables');
+console.log('   - Get them from: https://partner.steamgames.com/');
+console.log('   - Extract and copy "redistributable_bin" to "steamworks_sdk/" in your project');
+console.log('');
+console.log('2. 🔧 Configure your Steam App ID');
+console.log('   - Option A: Create steam_appid.txt with your App ID');
+console.log('   - Option B: Pass App ID to steam.init(yourAppId)');
+console.log('   - For testing: Use App ID 480 (Spacewar)');
+console.log('');
+console.log('3. ✅ Verify setup');
+console.log('   Run: npm run verify-sdk');
+console.log('');
+console.log('📖 Complete setup guide:');
+console.log('https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/STEAMWORKS_SDK_SETUP.md');
+console.log('');
+console.log('⚠️  Legal Notice:');
+console.log('Due to Valve\'s licensing terms, the Steamworks SDK redistributables');
+console.log('cannot be bundled with this package and must be downloaded separately.');
+console.log('');

package/verify-sdk-setup.js

@@ -0,0 +1,220 @@
+#!/usr/bin/env node
+
+/**
+ * Steamworks SDK Installation Verification Script
+ * 
+ * This script checks if the Steamworks SDK redistributables are properly installed
+ * and provides helpful guidance if they're missing.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function checkSteamworksSDK() {
+  console.log('🔍 Steamworks SDK Installation Verification');
+  console.log('===========================================');
+  console.log('');
+
+  const possibleBasePaths = [
+    process.cwd(),
+    path.resolve(process.cwd(), '..'),
+    path.resolve(process.cwd(), '../..'),
+  ];
+
+  let foundSdk = false;
+  let sdkPath = '';
+
+  // Check for steamworks_sdk folder
+  for (const basePath of possibleBasePaths) {
+    const checkPath = path.join(basePath, 'steamworks_sdk', 'redistributable_bin');
+    if (fs.existsSync(checkPath)) {
+      foundSdk = true;
+      sdkPath = checkPath;
+      console.log(`✅ Found steamworks_sdk at: ${checkPath}`);
+      break;
+    }
+  }
+
+  if (!foundSdk) {
+    console.log('❌ Steamworks SDK not found!');
+    console.log('');
+    console.log('Expected folder structure:');
+    console.log('  steamworks_sdk/');
+    console.log('  └── redistributable_bin/');
+    console.log('      ├── win64/steam_api64.dll');
+    console.log('      ├── steam_api.dll');
+    console.log('      ├── osx/libsteam_api.dylib');
+    console.log('      └── linux64/libsteam_api.so');
+    console.log('');
+    console.log('📖 Setup Instructions:');
+    console.log('1. Download Steamworks SDK from: https://partner.steamgames.com/');
+    console.log('2. Extract the SDK archive');
+    console.log('3. Copy the "redistributable_bin" folder to "steamworks_sdk/" in your project');
+    console.log('4. See https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/STEAMWORKS_SDK_SETUP.md for detailed instructions');
+    console.log('');
+    console.log('Searched paths:');
+    possibleBasePaths.forEach(p => {
+      console.log(`  - ${path.join(p, 'steamworks_sdk', 'redistributable_bin')}`);
+    });
+    return false;
+  }
+
+  // Check platform-specific files
+  console.log('');
+  console.log('🔍 Checking platform-specific libraries...');
+  
+  const requiredFiles = [
+    { path: 'win64/steam_api64.dll', platform: 'Windows 64-bit' },
+    { path: 'steam_api.dll', platform: 'Windows 32-bit' },
+    { path: 'osx/libsteam_api.dylib', platform: 'macOS' },
+    { path: 'linux64/libsteam_api.so', platform: 'Linux 64-bit' }
+  ];
+
+  let allFilesPresent = true;
+  let currentPlatformFileExists = false;
+  const currentPlatform = process.platform;
+  const currentArch = process.arch;
+
+  requiredFiles.forEach(file => {
+    const filePath = path.join(sdkPath, file.path);
+    const exists = fs.existsSync(filePath);
+    
+    console.log(`  ${exists ? '✅' : '❌'} ${file.platform}: ${file.path}`);
+    
+    if (!exists) {
+      allFilesPresent = false;
+    }
+
+    // Check if current platform file exists
+    if (currentPlatform === 'win32' && currentArch === 'x64' && file.path === 'win64/steam_api64.dll' && exists) {
+      currentPlatformFileExists = true;
+    } else if (currentPlatform === 'win32' && currentArch !== 'x64' && file.path === 'steam_api.dll' && exists) {
+      currentPlatformFileExists = true;
+    } else if (currentPlatform === 'darwin' && file.path === 'osx/libsteam_api.dylib' && exists) {
+      currentPlatformFileExists = true;
+    } else if (currentPlatform === 'linux' && file.path === 'linux64/libsteam_api.so' && exists) {
+      currentPlatformFileExists = true;
+    }
+  });
+
+  console.log('');
+
+  // Check steam_appid.txt (optional)
+  const steamAppIdPath = path.join(process.cwd(), 'steam_appid.txt');
+  const hasAppId = fs.existsSync(steamAppIdPath);
+  
+  console.log('🔍 Checking steam_appid.txt (optional)...');
+  if (hasAppId) {
+    const appId = fs.readFileSync(steamAppIdPath, 'utf8').trim();
+    console.log(`✅ steam_appid.txt found with App ID: ${appId}`);
+    if (appId === '480') {
+      console.log('   Note: Using Spacewar (480) - perfect for testing!');
+    }
+  } else {
+    console.log('ℹ️  steam_appid.txt not found (this is optional)');
+    console.log('   You can either create this file OR pass the App ID to steam.init(appId)');
+  }
+
+  console.log('');
+  console.log('📊 Summary');
+  console.log('==========');
+
+  if (foundSdk && currentPlatformFileExists) {
+    console.log('🎉 Great! Your Steamworks SDK setup is ready.');
+    console.log('');
+    console.log('✅ Steamworks SDK redistributables installed');
+    console.log(`✅ ${getCurrentPlatformName()} library available`);
+    if (hasAppId) {
+      console.log('✅ steam_appid.txt configured');
+    } else {
+      console.log('ℹ️  steam_appid.txt not found (pass App ID to steam.init() instead)');
+    }
+    console.log('');
+    console.log('You can now use steamworks-ffi-node in your project!');
+    console.log('');
+    console.log('Next steps:');
+    console.log('1. Make sure Steam client is running');
+    console.log('2. Import steamworks-ffi-node in your code');
+    if (hasAppId) {
+      console.log('3. Initialize the SDK with steam.init()');
+    } else {
+      console.log('3. Initialize the SDK with steam.init(yourAppId) or create steam_appid.txt');
+    }
+    return true;
+  } else {
+    console.log('⚠️  Setup incomplete. Please address the issues above.');
+    console.log('');
+    
+    if (!foundSdk) {
+      console.log('❌ Steamworks SDK redistributables missing');
+    } else if (!currentPlatformFileExists) {
+      console.log(`❌ Library for ${getCurrentPlatformName()} missing`);
+    }
+    
+    console.log('');
+    console.log('📖 See https://github.com/ArtyProf/steamworks-ffi-node/blob/main/docs/STEAMWORKS_SDK_SETUP.md for detailed setup instructions');
+    return false;
+  }
+}
+
+function getCurrentPlatformName() {
+  const platform = process.platform;
+  const arch = process.arch;
+  
+  if (platform === 'win32') {
+    return arch === 'x64' ? 'Windows 64-bit' : 'Windows 32-bit';
+  } else if (platform === 'darwin') {
+    return 'macOS';
+  } else if (platform === 'linux') {
+    return 'Linux 64-bit';
+  } else {
+    return `${platform} (${arch})`;
+  }
+}
+
+// Test basic functionality if SDK is installed
+function testBasicFunctionality() {
+  console.log('');
+  console.log('🧪 Testing Basic Functionality');
+  console.log('===============================');
+  
+  try {
+    console.log('Attempting to load steamworks-ffi-node...');
+    
+    // Try to require the package
+    const SteamworksSDK = require('./dist/index.js').default || require('./dist/index.js');
+    console.log('✅ Package loaded successfully');
+    
+    // Try to create instance (this will test SDK loading)
+    console.log('Testing SDK initialization...');
+    const steam = new SteamworksSDK();
+    console.log('✅ SteamworksSDK instance created');
+    
+    console.log('');
+    console.log('🎉 Basic functionality test passed!');
+    console.log('Your setup appears to be working correctly.');
+    
+  } catch (error) {
+    console.log('❌ Basic functionality test failed');
+    console.log(`Error: ${error.message}`);
+    console.log('');
+    console.log('This could indicate:');
+    console.log('- Package not built (run "npm run build")');
+    console.log('- Missing dependencies');
+    console.log('- Incorrect SDK installation');
+  }
+}
+
+// Main execution
+if (require.main === module) {
+  const success = checkSteamworksSDK();
+  
+  if (success) {
+    testBasicFunctionality();
+  }
+  
+  console.log('');
+  console.log('For more help, visit: https://github.com/ArtyProf/steamworks-ffi-node');
+}
+
+module.exports = { checkSteamworksSDK };