steamworks-ffi-node 0.5.2 → 0.6.0

package/docs/README.md

@@ -0,0 +1,155 @@
+# 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
+```
+
+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)
+
+## 🚀 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
+
+**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 ✨
+
+📁 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,20 +1,25 @@
 {
   "name": "steamworks-ffi-node",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "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: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:richpresence-overlay:ts": "ts-node tests/ts/test-richpresence-overlay.ts",
     "prepublishOnly": "npm run build"
   },
@@ -28,10 +33,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 };

package/THIRD_PARTY_LICENSES.md

@@ -1,24 +0,0 @@
-# Third-Party Licenses
-
-## Steamworks SDK Redistributables
-
-This package includes redistributable binaries from the Steamworks SDK.
-
-**Copyright**: © Valve Corporation. All rights reserved.
-
-**License**: These redistributables are distributed under the Steamworks SDK Access Agreement.
-
-The Steamworks SDK redistributables are provided by Valve Corporation and are subject to the Steamworks SDK Access Agreement available at:
-https://partner.steamgames.com/documentation/sdk_access_agreement
-
-### Included Components:
-- `steamworks_sdk/redistributable_bin/` - Platform-specific Steam API libraries
-  - Windows: steam_api64.dll, steam_api.dll
-  - macOS: libsteam_api.dylib
-  - Linux: libsteam_api.so
-
-These files are distributed in accordance with Section 1.1(b) of the Steamworks SDK Access Agreement, which permits reproduction and distribution of SDK Redistributables in object code form along with licensee software.
-
-## Package License
-
-The wrapper code in this package (excluding Steamworks SDK redistributables) is licensed under the MIT License. See LICENSE file for details.