steamworks-ffi-node 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Artur Khutak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,266 @@
+# Steamworks FFI - Real Steam Integration
+
+A production-ready TypeScript/JavaScript wrapper for the Steamworks SDK using Koffi FFI, designed for Node.js and Electron applications with **real Steam client integration**.
+
+> ✅ **No C++ Compilation Required**: Uses Koffi FFI for seamless installation without Visual Studio Build Tools!
+
+## 🎯 Features
+
+- **Real Steam Integration**: Direct FFI calls to Steamworks C++ SDK
+- **Cross-Platform**: Windows, macOS, and Linux support
+- **Electron Ready**: Perfect for Electron applications
+- **Production Ready**: Full Steam client connection and API access
+- **TypeScript Support**: Complete TypeScript definitions included
+- **Achievement System**: Full CRUD operations for Steam achievements
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+**Before using, you need:**
+
+1. **Steamworks SDK**: Download from [Steam Partner Portal](https://partner.steamgames.com/) and place in `steamworks_sdk/` directory
+
+2. **Steam Client**: Must be running and logged in for real integration
+
+### Installation
+
+```bash
+# Install dependencies (using Koffi FFI - no C++ compilation required!)
+npm install
+
+# Build TypeScript
+npm run build
+```
+
+### Basic Usage
+
+```typescript
+import Steam from 'steamworks-ffi';
+
+// Initialize real Steam connection
+const steam = Steam.getInstance();
+const initialized = steam.init({ appId: 480 }); // Your Steam App ID
+
+if (initialized) {
+  // Get achievements from Steam servers
+  const achievements = await steam.getAllAchievements();
+  console.log('Real Steam achievements:', achievements);
+  
+  // Unlock achievement (permanent in Steam!)
+  await steam.unlockAchievement('ACH_WIN_ONE_GAME');
+  
+  // Check unlock status from Steam
+  const isUnlocked = await steam.isAchievementUnlocked('ACH_WIN_ONE_GAME');
+  console.log('Achievement unlocked:', isUnlocked);
+}
+
+// Cleanup
+steam.shutdown();
+```
+
+### JavaScript (CommonJS)
+
+```javascript
+const Steam = require('steamworks-ffi').default;
+
+async function example() {
+  const steam = Steam.getInstance();
+  
+  if (steam.init({ appId: 480 })) {
+    const achievements = await steam.getAllAchievements();
+    console.log(`Found ${achievements.length} achievements`);
+    
+    // Unlock first locked achievement
+    const locked = achievements.find(a => !a.unlocked);
+    if (locked) {
+      await steam.unlockAchievement(locked.apiName);
+    }
+  }
+  
+  steam.shutdown();
+}
+
+example();
+```
+
+## 📚 API Reference
+
+### Steam Class
+
+#### `Steam.getInstance()`
+Get the singleton Steam instance.
+
+#### `init(options: SteamInitOptions): boolean`
+Initialize the Steam API.
+- `options.appId`: Your Steam Application ID
+
+#### `shutdown(): void`
+Shutdown the Steam API and cleanup resources.
+
+#### `getStatus(): SteamStatus`
+Get current Steam status information.
+
+### Achievement Methods
+
+#### `getAllAchievements(): Promise<SteamAchievement[]>`
+Get all available achievements for the app.
+
+#### `unlockAchievement(apiName: string): Promise<boolean>`
+Unlock a specific achievement.
+
+#### `clearAchievement(apiName: string): Promise<boolean>`
+Clear/reset an achievement (for testing).
+
+#### `isAchievementUnlocked(apiName: string): Promise<boolean>`
+Check if an achievement is unlocked.
+
+#### `getAchievement(apiName: string): Promise<SteamAchievement | null>`
+Get details for a specific achievement.
+
+#### `getTotalCount(): Promise<number>`
+Get total number of achievements.
+
+#### `getUnlockedCount(): Promise<number>`
+Get number of unlocked achievements.
+
+### Types
+
+```typescript
+interface SteamAchievement {
+  apiName: string;        // Internal achievement ID
+  displayName: string;    // User-friendly name
+  description: string;    // Achievement description
+  unlocked: boolean;      // Whether it's unlocked
+  unlockTime: number;     // Unix timestamp of unlock (0 if locked)
+}
+
+interface SteamInitOptions {
+  appId: number;          // Your Steam Application ID
+}
+
+interface SteamStatus {
+  initialized: boolean;   // Whether Steam API is initialized
+  appId: number;         // Current app ID
+  steamId: string;       // Current user's Steam ID
+}
+```
+
+## 🎮 Real Steam Integration
+
+This library connects directly to the Steam client and Steamworks SDK:
+
+```javascript
+// Real Steam API - no mocking!
+const steam = Steam.getInstance();
+steam.init({ appId: 480 }); // Connects to actual Steam
+
+// Live achievements from Steam servers
+const achievements = await steam.getAllAchievements();
+console.log(achievements); // Real achievement data from your Steam app
+
+// Permanent achievement unlock in Steam
+await steam.unlockAchievement('YOUR_ACHIEVEMENT');
+// ^ This shows up in Steam overlay and is saved permanently
+```
+
+**What happens when you unlock an achievement:**
+- ✅ Steam overlay notification appears
+- ✅ Achievement saved to Steam servers permanently
+- ✅ Syncs across all devices
+- ✅ Appears in Steam profile
+- ✅ Counts toward Steam statistics
+
+## 🖥️ Electron Integration
+
+For Electron applications, just use it in your main process:
+
+```typescript
+// main.ts
+import { app } from 'electron';
+import Steam from 'steamworks-ffi';
+
+app.whenReady().then(() => {
+  const steam = Steam.getInstance();
+  
+  if (steam.init({ appId: YOUR_STEAM_APP_ID })) {
+    console.log('Steam initialized in Electron!');
+    
+    // Handle achievement unlocks from renderer process
+    // via IPC if needed
+  }
+});
+
+app.on('before-quit', () => {
+  Steam.getInstance().shutdown();
+});
+```
+
+## 🏗️ Production Setup
+
+### Steamworks SDK Setup
+
+1. **Download SDK**: Get from [Steam Partner Portal](https://partner.steamgames.com/)
+2. **Extract to project**:
+   ```
+   steamworks_sdk/
+   ├── public/steam/           # Header files
+   └── redistributable_bin/    # Native libraries
+       ├── win64/steam_api64.dll
+       ├── osx/libsteam_api.dylib
+       └── linux64/libsteam_api.so
+   ```
+3. **Get Steam App ID**: Register your game on Steamworks
+4. **Create steam_appid.txt**: File with your App ID in project root
+
+### Testing Setup
+
+For immediate testing, use Spacewar (App ID 480):
+- Free Steam app for testing
+- Add to Steam library: steam://install/480
+- Requires Steam client running and logged in
+
+## 🔧 Requirements
+
+### Development
+- **Node.js**: 18+ 
+- **TypeScript**: 5.0+ (optional)
+- **Visual Studio Build Tools**: C++ workload required
+- **Python**: For native module compilation
+
+### Runtime
+- **Steam Client**: Must be running and logged in
+- **Steamworks SDK**: Redistributable binaries required
+- **Valid Steam App ID**: From registered Steam application
+
+### Platform Support
+- ✅ **Windows**: steam_api64.dll / steam_api.dll
+- ✅ **macOS**: libsteam_api.dylib  
+- ✅ **Linux**: libsteam_api.so
+
+## 🚀 Quick Start
+
+```bash
+# 1. Setup environment
+npm run setup
+
+# 2. Install dependencies
+npm install  
+
+# 3. Build TypeScript
+npm run build
+
+# 4. Test with Steam
+npm start
+```
+
+## 🔧 Troubleshooting
+
+**"Library not found"**: Install Steamworks SDK to `steamworks_sdk/`  
+**"SteamAPI_Init failed"**: Make sure Steam client is running  
+**Build errors**: Install Visual Studio C++ Build Tools  
+**"Missing VC++ toolset"**: Add C++ workload in VS Installer  
+
+## 📄 License
+
+MIT License - see LICENSE file for details.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import SteamworksSDK from './steam';
+import { SteamAchievement, SteamInitOptions, SteamStatus } from './types';
+export { SteamAchievement, SteamInitOptions, SteamStatus };
+export default SteamworksSDK;
+export { SteamworksSDK as Steam };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC;AAG3D,eAAe,aAAa,CAAC;AAG7B,OAAO,EAAE,aAAa,IAAI,KAAK,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Steam = void 0;
+const steam_1 = __importDefault(require("./steam"));
+exports.Steam = steam_1.default;
+// Export main Steam class
+exports.default = steam_1.default;
+// Example usage (commented out)
+/*
+// Initialize Steam
+const steam = SteamFFI.getInstance();
+const initialized = steam.init({ appId: 480 }); // Steam's test app
+
+if (initialized) {
+  // Get achievements
+  steam.getAllAchievements().then(achievements => {
+    console.log('Achievements:', achievements);
+    
+    if (achievements.length > 0) {
+      // Unlock first achievement
+      steam.unlockAchievement(achievements[0].apiName);
+    }
+  });
+}
+*/ 
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,oDAAoC;AAUV,gBAVnB,eAAa,CAUW;AAJ/B,0BAA0B;AAC1B,kBAAe,eAAa,CAAC;AAK7B,gCAAgC;AAChC;;;;;;;;;;;;;;;;EAgBE"}

package/dist/steam.d.ts

@@ -0,0 +1,83 @@
+import { SteamAchievement, SteamInitOptions, SteamStatus } from './types';
+/**
+ * Real Steamworks SDK implementation using Koffi FFI
+ * This connects directly to the actual Steam client and Steamworks SDK
+ */
+declare class SteamworksSDK {
+    private static instance;
+    private steamLib;
+    private initialized;
+    private appId;
+    private userStatsInterface;
+    private SteamAPI_Init;
+    private SteamAPI_Shutdown;
+    private SteamAPI_RunCallbacks;
+    private SteamAPI_IsSteamRunning;
+    private SteamAPI_SteamUserStats_v013;
+    private SteamAPI_SteamUser_v023;
+    private SteamAPI_ISteamUserStats_GetNumAchievements;
+    private SteamAPI_ISteamUserStats_GetAchievementName;
+    private SteamAPI_ISteamUserStats_GetAchievementDisplayAttribute;
+    private SteamAPI_ISteamUserStats_GetAchievement;
+    private SteamAPI_ISteamUserStats_SetAchievement;
+    private SteamAPI_ISteamUserStats_ClearAchievement;
+    private SteamAPI_ISteamUserStats_StoreStats;
+    private SteamAPI_ISteamUserStats_RequestCurrentStats;
+    private SteamAPI_ISteamUser_GetSteamID;
+    private constructor();
+    static getInstance(): SteamworksSDK;
+    /**
+     * Get platform-specific Steam library path
+     */
+    private getSteamLibraryPath;
+    /**
+     * Initialize Steam API with real Steamworks SDK
+     */
+    init(options: SteamInitOptions): boolean;
+    /**
+     * Shutdown Steam API
+     */
+    shutdown(): void;
+    /**
+     * Get current Steam status
+     */
+    getStatus(): SteamStatus;
+    /**
+     * Get all achievements from Steam
+     */
+    getAllAchievements(): Promise<SteamAchievement[]>;
+    /**
+     * Unlock achievement in Steam
+     */
+    unlockAchievement(apiName: string): Promise<boolean>;
+    /**
+     * Clear achievement in Steam (for testing)
+     */
+    clearAchievement(apiName: string): Promise<boolean>;
+    /**
+     * Check if achievement is unlocked
+     */
+    isAchievementUnlocked(apiName: string): Promise<boolean>;
+    /**
+     * Get achievement by API name
+     */
+    getAchievement(apiName: string): Promise<SteamAchievement | null>;
+    /**
+     * Get total number of achievements
+     */
+    getTotalCount(): Promise<number>;
+    /**
+     * Get number of unlocked achievements
+     */
+    getUnlockedCount(): Promise<number>;
+    /**
+     * Run Steam callbacks to process pending events
+     */
+    runCallbacks(): void;
+    /**
+     * Check if Steam client is running
+     */
+    isSteamRunning(): boolean;
+}
+export default SteamworksSDK;
+//# sourceMappingURL=steam.d.ts.map

package/dist/steam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steam.d.ts","sourceRoot":"","sources":["../src/steam.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1E;;;GAGG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,kBAAkB,CAAa;IAGvC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,uBAAuB,CAAuB;IACtD,OAAO,CAAC,4BAA4B,CAAuB;IAC3D,OAAO,CAAC,uBAAuB,CAAuB;IACtD,OAAO,CAAC,2CAA2C,CAAuB;IAC1E,OAAO,CAAC,2CAA2C,CAAuB;IAC1E,OAAO,CAAC,uDAAuD,CAAuB;IACtF,OAAO,CAAC,uCAAuC,CAAuB;IACtE,OAAO,CAAC,uCAAuC,CAAuB;IACtE,OAAO,CAAC,yCAAyC,CAAuB;IACxE,OAAO,CAAC,mCAAmC,CAAuB;IAClE,OAAO,CAAC,4CAA4C,CAAuB;IAC3E,OAAO,CAAC,8BAA8B,CAAuB;IAE7D,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,aAAa;IAOnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6B3B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAuFxC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAUhB;;OAEG;IACH,SAAS,IAAI,WAAW;IAsBxB;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA4DvD;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqC1D;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqCzD;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB9D;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKvE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAatC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKzC;;OAEG;IACH,YAAY,IAAI,IAAI;IAUpB;;OAEG;IACH,cAAc,IAAI,OAAO;CAW1B;AAED,eAAe,aAAa,CAAC"}

package/dist/steam.js

@@ -0,0 +1,388 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const koffi = __importStar(require("koffi"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+/**
+ * Real Steamworks SDK implementation using Koffi FFI
+ * This connects directly to the actual Steam client and Steamworks SDK
+ */
+class SteamworksSDK {
+    constructor() {
+        this.steamLib = null;
+        this.initialized = false;
+        this.appId = 0;
+        this.userStatsInterface = null;
+    }
+    static getInstance() {
+        if (!SteamworksSDK.instance) {
+            SteamworksSDK.instance = new SteamworksSDK();
+        }
+        return SteamworksSDK.instance;
+    }
+    /**
+     * Get platform-specific Steam library path
+     */
+    getSteamLibraryPath() {
+        const platform = process.platform;
+        const arch = process.arch;
+        let libPath;
+        if (platform === 'win32') {
+            if (arch === 'x64') {
+                libPath = path.join(__dirname, '../steamworks_sdk/redistributable_bin/win64/steam_api64.dll');
+            }
+            else {
+                libPath = path.join(__dirname, '../steamworks_sdk/redistributable_bin/steam_api.dll');
+            }
+        }
+        else if (platform === 'darwin') {
+            libPath = path.join(__dirname, '../steamworks_sdk/redistributable_bin/osx/libsteam_api.dylib');
+        }
+        else if (platform === 'linux') {
+            libPath = path.join(__dirname, '../steamworks_sdk/redistributable_bin/linux64/libsteam_api.so');
+        }
+        else {
+            throw new Error(`Unsupported platform: ${platform}`);
+        }
+        // Check if the library exists
+        if (!fs.existsSync(libPath)) {
+            throw new Error(`Steamworks SDK library not found at: ${libPath}\n` +
+                'Please download Steamworks SDK and place it in the steamworks_sdk/ directory.');
+        }
+        return libPath;
+    }
+    /**
+     * Initialize Steam API with real Steamworks SDK
+     */
+    init(options) {
+        try {
+            this.appId = options.appId;
+            // Set Steam App ID in environment
+            process.env.SteamAppId = this.appId.toString();
+            // Also create steam_appid.txt file (Steam requirement)
+            const appIdFilePath = path.join(process.cwd(), 'steam_appid.txt');
+            fs.writeFileSync(appIdFilePath, this.appId.toString());
+            console.log(`🔌 Loading Steamworks SDK for App ID: ${this.appId}`);
+            // Load Steam API library using Koffi
+            const libPath = this.getSteamLibraryPath();
+            console.log(`📚 Loading library: ${libPath}`);
+            this.steamLib = koffi.load(libPath);
+            // Define function signatures using Koffi
+            this.SteamAPI_Init = this.steamLib.func('SteamAPI_InitSafe', 'bool', []);
+            this.SteamAPI_Shutdown = this.steamLib.func('SteamAPI_Shutdown', 'void', []);
+            this.SteamAPI_RunCallbacks = this.steamLib.func('SteamAPI_RunCallbacks', 'void', []);
+            this.SteamAPI_IsSteamRunning = this.steamLib.func('SteamAPI_IsSteamRunning', 'bool', []);
+            this.SteamAPI_SteamUserStats_v013 = this.steamLib.func('SteamAPI_SteamUserStats_v013', 'void*', []);
+            this.SteamAPI_SteamUser_v023 = this.steamLib.func('SteamAPI_SteamUser_v023', 'void*', []);
+            this.SteamAPI_ISteamUserStats_GetNumAchievements = this.steamLib.func('SteamAPI_ISteamUserStats_GetNumAchievements', 'uint32', ['void*']);
+            this.SteamAPI_ISteamUserStats_GetAchievementName = this.steamLib.func('SteamAPI_ISteamUserStats_GetAchievementName', 'str', ['void*', 'uint32']);
+            this.SteamAPI_ISteamUserStats_GetAchievementDisplayAttribute = this.steamLib.func('SteamAPI_ISteamUserStats_GetAchievementDisplayAttribute', 'str', ['void*', 'str', 'str']);
+            this.SteamAPI_ISteamUserStats_GetAchievement = this.steamLib.func('SteamAPI_ISteamUserStats_GetAchievement', 'bool', ['void*', 'str', 'bool*']);
+            this.SteamAPI_ISteamUserStats_SetAchievement = this.steamLib.func('SteamAPI_ISteamUserStats_SetAchievement', 'bool', ['void*', 'str']);
+            this.SteamAPI_ISteamUserStats_ClearAchievement = this.steamLib.func('SteamAPI_ISteamUserStats_ClearAchievement', 'bool', ['void*', 'str']);
+            this.SteamAPI_ISteamUserStats_StoreStats = this.steamLib.func('SteamAPI_ISteamUserStats_StoreStats', 'bool', ['void*']);
+            this.SteamAPI_ISteamUserStats_RequestCurrentStats = this.steamLib.func('SteamAPI_ISteamUserStats_RequestUserStats', 'uint64', ['void*', 'uint64']);
+            this.SteamAPI_ISteamUser_GetSteamID = this.steamLib.func('SteamAPI_ISteamUser_GetSteamID', 'uint64', ['void*']);
+            console.log('🚀 Initializing Steam API...');
+            // Initialize Steam API
+            const initResult = this.SteamAPI_Init();
+            if (!initResult) {
+                throw new Error('SteamAPI_Init() failed. Make sure Steam client is running and you\'re logged in.');
+            }
+            // Check if Steam is running
+            const steamRunning = this.SteamAPI_IsSteamRunning();
+            if (!steamRunning) {
+                console.warn('⚠️ Steam client might not be running properly');
+            }
+            // Get UserStats interface
+            this.userStatsInterface = this.SteamAPI_SteamUserStats_v013();
+            if (!this.userStatsInterface || this.userStatsInterface === null) {
+                throw new Error('Failed to get SteamUserStats interface');
+            }
+            // Request current stats from Steam servers
+            console.log('📊 Requesting current stats from Steam...');
+            // Use 0 as SteamID to request stats for current user
+            const statsRequested = this.SteamAPI_ISteamUserStats_RequestCurrentStats(this.userStatsInterface, 0);
+            if (!statsRequested) {
+                console.warn('⚠️ Failed to request current stats from Steam servers');
+            }
+            // Run callbacks to process any pending Steam events
+            this.SteamAPI_RunCallbacks();
+            this.initialized = true;
+            console.log('✅ Steam API initialized successfully!');
+            console.log(`🎮 Connected to Steam for App ID: ${this.appId}`);
+            return true;
+        }
+        catch (error) {
+            console.error('❌ Failed to initialize Steam API:', error.message);
+            console.error('💡 Make sure:');
+            console.error('   1. Steam client is running and you\'re logged in');
+            console.error('   2. Steamworks SDK is in steamworks_sdk/ directory');
+            console.error('   3. You have Visual Studio C++ Redistributable installed');
+            return false;
+        }
+    }
+    /**
+     * Shutdown Steam API
+     */
+    shutdown() {
+        if (this.steamLib && this.initialized) {
+            console.log('🔌 Shutting down Steam API...');
+            this.SteamAPI_Shutdown();
+            this.initialized = false;
+            this.userStatsInterface = null;
+            console.log('✅ Steam API shutdown complete');
+        }
+    }
+    /**
+     * Get current Steam status
+     */
+    getStatus() {
+        let steamId = '0';
+        if (this.initialized && this.steamLib) {
+            try {
+                const userInterface = this.SteamAPI_SteamUser_v023();
+                if (userInterface && userInterface !== null) {
+                    const steamIdNum = this.SteamAPI_ISteamUser_GetSteamID(userInterface);
+                    steamId = steamIdNum.toString();
+                }
+            }
+            catch (error) {
+                console.warn('Failed to get Steam ID:', error.message);
+            }
+        }
+        return {
+            initialized: this.initialized,
+            appId: this.appId,
+            steamId
+        };
+    }
+    /**
+     * Get all achievements from Steam
+     */
+    async getAllAchievements() {
+        if (!this.initialized || !this.steamLib || !this.userStatsInterface) {
+            console.warn('⚠️ Steam API not initialized');
+            return [];
+        }
+        try {
+            // Run callbacks to ensure we have latest data
+            this.SteamAPI_RunCallbacks();
+            const achievements = [];
+            const numAchievements = this.SteamAPI_ISteamUserStats_GetNumAchievements(this.userStatsInterface);
+            console.log(`📋 Found ${numAchievements} achievements in Steam`);
+            for (let i = 0; i < numAchievements; i++) {
+                try {
+                    // Get achievement API name
+                    const apiName = this.SteamAPI_ISteamUserStats_GetAchievementName(this.userStatsInterface, i);
+                    if (!apiName)
+                        continue;
+                    // Get display name
+                    const displayName = this.SteamAPI_ISteamUserStats_GetAchievementDisplayAttribute(this.userStatsInterface, apiName, 'name') || apiName;
+                    // Get description
+                    const description = this.SteamAPI_ISteamUserStats_GetAchievementDisplayAttribute(this.userStatsInterface, apiName, 'desc') || '';
+                    // Check if unlocked
+                    const unlockedPtr = koffi.alloc('bool', 1);
+                    const hasAchievement = this.SteamAPI_ISteamUserStats_GetAchievement(this.userStatsInterface, apiName, unlockedPtr);
+                    const unlocked = hasAchievement ? koffi.decode(unlockedPtr, 'bool') : false;
+                    achievements.push({
+                        apiName,
+                        displayName,
+                        description,
+                        unlocked,
+                        unlockTime: unlocked ? Date.now() : 0 // Steam doesn't provide unlock time easily
+                    });
+                }
+                catch (error) {
+                    console.warn(`Failed to get achievement ${i}:`, error.message);
+                }
+            }
+            return achievements;
+        }
+        catch (error) {
+            console.error('❌ Failed to get achievements:', error.message);
+            return [];
+        }
+    }
+    /**
+     * Unlock achievement in Steam
+     */
+    async unlockAchievement(apiName) {
+        if (!this.initialized || !this.steamLib || !this.userStatsInterface) {
+            console.warn('⚠️ Steam API not initialized');
+            return false;
+        }
+        try {
+            console.log(`🔓 Attempting to unlock achievement: ${apiName}`);
+            // Set the achievement
+            const result = this.SteamAPI_ISteamUserStats_SetAchievement(this.userStatsInterface, apiName);
+            if (result) {
+                // Store stats to commit the achievement to Steam servers
+                const storeResult = this.SteamAPI_ISteamUserStats_StoreStats(this.userStatsInterface);
+                if (storeResult) {
+                    // Run callbacks to process the achievement unlock
+                    this.SteamAPI_RunCallbacks();
+                    console.log(`🏆 Achievement unlocked successfully: ${apiName}`);
+                    return true;
+                }
+                else {
+                    console.error(`❌ Failed to store stats for achievement: ${apiName}`);
+                    return false;
+                }
+            }
+            else {
+                console.error(`❌ Failed to set achievement: ${apiName}`);
+                return false;
+            }
+        }
+        catch (error) {
+            console.error(`❌ Error unlocking achievement ${apiName}:`, error.message);
+            return false;
+        }
+    }
+    /**
+     * Clear achievement in Steam (for testing)
+     */
+    async clearAchievement(apiName) {
+        if (!this.initialized || !this.steamLib || !this.userStatsInterface) {
+            console.warn('⚠️ Steam API not initialized');
+            return false;
+        }
+        try {
+            console.log(`🔒 Attempting to clear achievement: ${apiName}`);
+            // Clear the achievement
+            const result = this.SteamAPI_ISteamUserStats_ClearAchievement(this.userStatsInterface, apiName);
+            if (result) {
+                // Store stats to commit the change to Steam servers
+                const storeResult = this.SteamAPI_ISteamUserStats_StoreStats(this.userStatsInterface);
+                if (storeResult) {
+                    // Run callbacks to process the change
+                    this.SteamAPI_RunCallbacks();
+                    console.log(`🔒 Achievement cleared successfully: ${apiName}`);
+                    return true;
+                }
+                else {
+                    console.error(`❌ Failed to store stats for clearing achievement: ${apiName}`);
+                    return false;
+                }
+            }
+            else {
+                console.error(`❌ Failed to clear achievement: ${apiName}`);
+                return false;
+            }
+        }
+        catch (error) {
+            console.error(`❌ Error clearing achievement ${apiName}:`, error.message);
+            return false;
+        }
+    }
+    /**
+     * Check if achievement is unlocked
+     */
+    async isAchievementUnlocked(apiName) {
+        if (!this.initialized || !this.steamLib || !this.userStatsInterface) {
+            return false;
+        }
+        try {
+            const unlockedPtr = koffi.alloc('bool', 1);
+            const hasAchievement = this.SteamAPI_ISteamUserStats_GetAchievement(this.userStatsInterface, apiName, unlockedPtr);
+            return hasAchievement ? koffi.decode(unlockedPtr, 'bool') : false;
+        }
+        catch (error) {
+            console.error(`❌ Error checking achievement ${apiName}:`, error.message);
+            return false;
+        }
+    }
+    /**
+     * Get achievement by API name
+     */
+    async getAchievement(apiName) {
+        const achievements = await this.getAllAchievements();
+        return achievements.find(a => a.apiName === apiName) || null;
+    }
+    /**
+     * Get total number of achievements
+     */
+    async getTotalCount() {
+        if (!this.initialized || !this.steamLib || !this.userStatsInterface) {
+            return 0;
+        }
+        try {
+            return this.SteamAPI_ISteamUserStats_GetNumAchievements(this.userStatsInterface);
+        }
+        catch (error) {
+            console.error('❌ Error getting achievement count:', error.message);
+            return 0;
+        }
+    }
+    /**
+     * Get number of unlocked achievements
+     */
+    async getUnlockedCount() {
+        const achievements = await this.getAllAchievements();
+        return achievements.filter(a => a.unlocked).length;
+    }
+    /**
+     * Run Steam callbacks to process pending events
+     */
+    runCallbacks() {
+        if (this.initialized && this.steamLib) {
+            try {
+                this.SteamAPI_RunCallbacks();
+            }
+            catch (error) {
+                console.warn('Warning: Error running Steam callbacks:', error.message);
+            }
+        }
+    }
+    /**
+     * Check if Steam client is running
+     */
+    isSteamRunning() {
+        if (this.initialized && this.steamLib) {
+            try {
+                return this.SteamAPI_IsSteamRunning();
+            }
+            catch (error) {
+                console.warn('Warning: Error checking if Steam is running:', error.message);
+                return false;
+            }
+        }
+        return false;
+    }
+}
+exports.default = SteamworksSDK;
+//# sourceMappingURL=steam.js.map

package/dist/steam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steam.js","sourceRoot":"","sources":["../src/steam.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA+B;AAC/B,2CAA6B;AAC7B,uCAAyB;AAGzB;;;GAGG;AACH,MAAM,aAAa;IAwBjB;QAtBQ,aAAQ,GAA2B,IAAI,CAAC;QACxC,gBAAW,GAAY,KAAK,CAAC;QAC7B,UAAK,GAAW,CAAC,CAAC;QAClB,uBAAkB,GAAQ,IAAI,CAAC;IAmBhB,CAAC;IAExB,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC5B,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED;;OAEG;IACK,mBAAmB;QACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAE1B,IAAI,OAAe,CAAC;QAEpB,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,6DAA6D,CAAC,CAAC;YAChG,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,qDAAqD,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;aAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,8DAA8D,CAAC,CAAC;QACjG,CAAC;aAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YAChC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,+DAA+D,CAAC,CAAC;QAClG,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,wCAAwC,OAAO,IAAI;gBACjE,+EAA+E,CAAC,CAAC;QACrF,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;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,yCAAyC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAEnE,qCAAqC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,EAAE,CAAC,CAAC;YAE9C,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEpC,yCAAyC;YACzC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACzE,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YAC7E,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,uBAAuB,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACrF,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,yBAAyB,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YAEzF,IAAI,CAAC,4BAA4B,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,8BAA8B,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YACpG,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,yBAAyB,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YAE1F,IAAI,CAAC,2CAA2C,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,6CAA6C,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1I,IAAI,CAAC,2CAA2C,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,6CAA6C,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YACjJ,IAAI,CAAC,uDAAuD,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,yDAAyD,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAC7K,IAAI,CAAC,uCAAuC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,yCAAyC,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;YAChJ,IAAI,CAAC,uCAAuC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,yCAAyC,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YACvI,IAAI,CAAC,yCAAyC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,2CAA2C,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3I,IAAI,CAAC,mCAAmC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,qCAAqC,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YACxH,IAAI,CAAC,4CAA4C,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,2CAA2C,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YACnJ,IAAI,CAAC,8BAA8B,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,gCAAgC,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YAEhH,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YAE5C,uBAAuB;YACvB,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAExC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;YACtG,CAAC;YAED,4BAA4B;YAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAC;YACpD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YAChE,CAAC;YAED,0BAA0B;YAC1B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,4BAA4B,EAAE,CAAC;YAC9D,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;gBACjE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC5D,CAAC;YAED,2CAA2C;YAC3C,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;YACzD,qDAAqD;YACrD,MAAM,cAAc,GAAG,IAAI,CAAC,4CAA4C,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;YAErG,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;YACxE,CAAC;YAED,oDAAoD;YACpD,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAE7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAE/D,OAAO,IAAI,CAAC;QAEd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YAC7E,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;YACrE,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;YACtE,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAC5E,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;YAC7C,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACzB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YACzB,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,OAAO,GAAG,GAAG,CAAC;QAElB,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAC;gBACrD,IAAI,aAAa,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;oBAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,8BAA8B,CAAC,aAAa,CAAC,CAAC;oBACtE,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;gBAClC,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAED,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB;QACtB,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,CAAC;YACH,8CAA8C;YAC9C,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAE7B,MAAM,YAAY,GAAuB,EAAE,CAAC;YAC5C,MAAM,eAAe,GAAG,IAAI,CAAC,2CAA2C,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAElG,OAAO,CAAC,GAAG,CAAC,YAAY,eAAe,wBAAwB,CAAC,CAAC;YAEjE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzC,IAAI,CAAC;oBACH,2BAA2B;oBAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,2CAA2C,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;oBAC7F,IAAI,CAAC,OAAO;wBAAE,SAAS;oBAEvB,mBAAmB;oBACnB,MAAM,WAAW,GAAG,IAAI,CAAC,uDAAuD,CAC9E,IAAI,CAAC,kBAAkB,EAAE,OAAO,EAAE,MAAM,CACzC,IAAI,OAAO,CAAC;oBAEb,kBAAkB;oBAClB,MAAM,WAAW,GAAG,IAAI,CAAC,uDAAuD,CAC9E,IAAI,CAAC,kBAAkB,EAAE,OAAO,EAAE,MAAM,CACzC,IAAI,EAAE,CAAC;oBAER,oBAAoB;oBACpB,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;oBAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,uCAAuC,CACjE,IAAI,CAAC,kBAAkB,EAAE,OAAO,EAAE,WAAW,CAC9C,CAAC;oBAEF,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;oBAE5E,YAAY,CAAC,IAAI,CAAC;wBAChB,OAAO;wBACP,WAAW;wBACX,WAAW;wBACX,QAAQ;wBACR,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,2CAA2C;qBAClF,CAAC,CAAC;gBAEL,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,GAAG,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;YAED,OAAO,YAAY,CAAC;QAEtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACzE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAAe;QACrC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,wCAAwC,OAAO,EAAE,CAAC,CAAC;YAE/D,sBAAsB;YACtB,MAAM,MAAM,GAAG,IAAI,CAAC,uCAAuC,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YAE9F,IAAI,MAAM,EAAE,CAAC;gBACX,yDAAyD;gBACzD,MAAM,WAAW,GAAG,IAAI,CAAC,mCAAmC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;gBAEtF,IAAI,WAAW,EAAE,CAAC;oBAChB,kDAAkD;oBAClD,IAAI,CAAC,qBAAqB,EAAE,CAAC;oBAE7B,OAAO,CAAC,GAAG,CAAC,yCAAyC,OAAO,EAAE,CAAC,CAAC;oBAChE,OAAO,IAAI,CAAC;gBACd,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,KAAK,CAAC,4CAA4C,OAAO,EAAE,CAAC,CAAC;oBACrE,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,gCAAgC,OAAO,EAAE,CAAC,CAAC;gBACzD,OAAO,KAAK,CAAC;YACf,CAAC;QAEH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,iCAAiC,OAAO,GAAG,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACrF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAe;QACpC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,uCAAuC,OAAO,EAAE,CAAC,CAAC;YAE9D,wBAAwB;YACxB,MAAM,MAAM,GAAG,IAAI,CAAC,yCAAyC,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YAEhG,IAAI,MAAM,EAAE,CAAC;gBACX,oDAAoD;gBACpD,MAAM,WAAW,GAAG,IAAI,CAAC,mCAAmC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;gBAEtF,IAAI,WAAW,EAAE,CAAC;oBAChB,sCAAsC;oBACtC,IAAI,CAAC,qBAAqB,EAAE,CAAC;oBAE7B,OAAO,CAAC,GAAG,CAAC,wCAAwC,OAAO,EAAE,CAAC,CAAC;oBAC/D,OAAO,IAAI,CAAC;gBACd,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,KAAK,CAAC,qDAAqD,OAAO,EAAE,CAAC,CAAC;oBAC9E,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;gBAC3D,OAAO,KAAK,CAAC;YACf,CAAC;QAEH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,OAAO,GAAG,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACpF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,OAAe;QACzC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACpE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,uCAAuC,CACjE,IAAI,CAAC,kBAAkB,EAAE,OAAO,EAAE,WAAW,CAC9C,CAAC;YAEF,OAAO,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAEpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,OAAO,GAAG,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACpF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACrD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACpE,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,2CAA2C,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YAC9E,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB;QACpB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACrD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC/B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,yCAAyC,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,uBAAuB,EAAE,CAAC;YACxC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,8CAA8C,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;gBACvF,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,kBAAe,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+export interface SteamAchievement {
+    apiName: string;
+    displayName: string;
+    description: string;
+    unlocked: boolean;
+    unlockTime: number;
+}
+export interface SteamInitOptions {
+    appId: number;
+}
+export interface SteamStatus {
+    initialized: boolean;
+    appId: number;
+    steamId: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "steamworks-ffi-node",
+  "version": "0.1.1",
+  "description": "Real Steamworks SDK wrapper using FFI for Node.js/Electron - Full Steam Integration",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "start": "node test.js",
+    "test": "node test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "koffi": "^2.8.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.20",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "steamworks_sdk/redistributable_bin/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "steam",
+    "steamworks",
+    "ffi",
+    "typescript",
+    "achievements",
+    "gaming",
+    "electron",
+    "cross-platform"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ArtyProf/steamworks-ffi-node.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ArtyProf/steamworks-ffi-node/issues"
+  },
+  "homepage": "https://github.com/ArtyProf/steamworks-ffi-node#readme",
+  "author": "ArtyProf",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/steamworks_sdk/README.md

@@ -0,0 +1,82 @@
+# Steamworks SDK Setup
+
+This directory should contain the Steamworks SDK files for real Steam integration.
+
+## 📥 How to Get Steamworks SDK
+
+1. **Register as Steam Partner**: Go to https://partner.steamgames.com/
+2. **Download Steamworks SDK**: Available in the partner portal after registration
+3. **Extract SDK**: Place the extracted files in this directory
+
+## 📁 Required Directory Structure
+
+```
+steamworks_sdk/
+├── public/
+│   └── steam/
+│       ├── steam_api.h
+│       ├── isteamuserstate.h
+│       └── ... (other header files)
+└── redistributable_bin/
+    ├── win64/
+    │   └── steam_api64.dll     # Windows 64-bit
+    ├── steam_api.dll           # Windows 32-bit
+    ├── osx/
+    │   └── libsteam_api.dylib  # macOS
+    └── linux64/
+        └── libsteam_api.so     # Linux 64-bit
+```
+
+## 🔑 Steam App ID
+
+You'll also need a valid Steam App ID:
+
+1. **Get App ID**: Register your application on Steamworks
+2. **Create steam_appid.txt**: Place your App ID in this file in the project root
+3. **Environment Variable**: The wrapper will set `SteamAppId` automatically
+
+## 🎮 Testing Without Real App ID
+
+For testing purposes, you can use Steam's test App ID `480` (Spacewar), but this requires:
+- Steam client running
+- Being logged into Steam
+- Having Spacewar in your library (it's free)
+
+## ⚡ Quick Setup
+
+1. Download Steamworks SDK from Steam Partner portal
+2. Extract to this directory maintaining the structure above
+3. Run: `npm run setup` to verify everything is configured
+4. Run: `npm install` to build FFI dependencies
+5. Run: `npm start` to test with real Steam integration
+
+## 🚨 Important Notes
+
+- **Keep SDK Private**: Steamworks SDK is under NDA - don't commit it to public repos
+- **Platform Specific**: Make sure to include binaries for all target platforms
+- **Steam Client Required**: Real integration requires Steam client to be running
+- **Valid App ID**: Production use requires a registered Steam application
+
+## 🔧 Troubleshooting
+
+**"Library not found" Error**:
+- Verify SDK files are in correct locations
+- Check file permissions
+- Ensure Visual Studio C++ Redistributable is installed
+
+**"SteamAPI_Init failed" Error**:
+- Make sure Steam client is running
+- Verify you're logged into Steam
+- Check that steam_appid.txt contains valid App ID
+- For App ID 480, make sure Spacewar is in your Steam library
+
+**Build Errors**:
+- Install Visual Studio Build Tools with C++ workload
+- Make sure Python is installed
+- Try running as Administrator
+
+## 📚 Documentation
+
+- **Steamworks API Reference**: https://partner.steamgames.com/doc/api
+- **Steam Partner Documentation**: Available after partner registration
+- **Integration Guides**: Check the official Steamworks documentation