steamworks-ffi-node 0.3.1 → 0.4.1

package/dist/steam.js

@@ -4,23 +4,36 @@ const SteamLibraryLoader_1 = require("./internal/SteamLibraryLoader");
 const SteamAPICore_1 = require("./internal/SteamAPICore");
 const SteamAchievementManager_1 = require("./internal/SteamAchievementManager");
 const SteamStatsManager_1 = require("./internal/SteamStatsManager");
+const SteamLeaderboardManager_1 = require("./internal/SteamLeaderboardManager");
 /**
  * Real Steamworks SDK implementation using Koffi FFI
  * This connects directly to the actual Steam client and Steamworks SDK
  *
- * Uses composition pattern with specialized modules:
- * - SteamLibraryLoader: Handles FFI library loading and function binding
- * - SteamAPICore: Manages Steam API lifecycle (init, shutdown, callbacks)
- * - SteamAchievementManager: Handles all achievement operations
- * - SteamStatsManager: Handles all stats operations
+ * Uses composition pattern with specialized managers:
+ * - achievements: SteamAchievementManager - All achievement operations
+ * - stats: SteamStatsManager - All stats operations
+ * - leaderboards: SteamLeaderboardManager - All leaderboard operations
+ *
+ * @example
+ * ```typescript
+ * const steam = Steam.getInstance();
+ * steam.init({ appId: 480 });
+ *
+ * // Use managers directly
+ * await steam.achievements.unlockAchievement('ACH_WIN_ONE_GAME');
+ * await steam.stats.setStatInt('NumGames', 1);
+ * await steam.leaderboards.uploadScore(handle, 1000, KeepBest);
+ * ```
  */
 class SteamworksSDK {
     constructor() {
-        // Initialize composed modules
+        // Initialize internal modules
         this.libraryLoader = new SteamLibraryLoader_1.SteamLibraryLoader();
         this.apiCore = new SteamAPICore_1.SteamAPICore(this.libraryLoader);
-        this.achievementManager = new SteamAchievementManager_1.SteamAchievementManager(this.libraryLoader, this.apiCore);
-        this.statsManager = new SteamStatsManager_1.SteamStatsManager(this.libraryLoader, this.apiCore);
+        // Initialize public managers
+        this.achievements = new SteamAchievementManager_1.SteamAchievementManager(this.libraryLoader, this.apiCore);
+        this.stats = new SteamStatsManager_1.SteamStatsManager(this.libraryLoader, this.apiCore);
+        this.leaderboards = new SteamLeaderboardManager_1.SteamLeaderboardManager(this.libraryLoader, this.apiCore);
     }
     static getInstance() {
         if (!SteamworksSDK.instance) {
@@ -28,6 +41,9 @@ class SteamworksSDK {
         }
         return SteamworksSDK.instance;
     }
+    // ========================================
+    // CORE API METHODS
+    // ========================================
     /**
      * Initialize Steam API with real Steamworks SDK
      */
@@ -46,48 +62,6 @@ class SteamworksSDK {
     getStatus() {
         return this.apiCore.getStatus();
     }
-    /**
-     * Get all achievements from Steam
-     */
-    async getAllAchievements() {
-        return this.achievementManager.getAllAchievements();
-    }
-    /**
-     * Unlock achievement in Steam
-     */
-    async unlockAchievement(achievementName) {
-        return this.achievementManager.unlockAchievement(achievementName);
-    }
-    /**
-     * Clear achievement in Steam (for testing)
-     */
-    async clearAchievement(achievementName) {
-        return this.achievementManager.clearAchievement(achievementName);
-    }
-    /**
-     * Check if achievement is unlocked
-     */
-    async isAchievementUnlocked(achievementName) {
-        return this.achievementManager.isAchievementUnlocked(achievementName);
-    }
-    /**
-     * Get achievement by API name
-     */
-    async getAchievementByName(achievementName) {
-        return this.achievementManager.getAchievementByName(achievementName);
-    }
-    /**
-     * Get total number of achievements
-     */
-    async getTotalAchievementCount() {
-        return this.achievementManager.getTotalAchievementCount();
-    }
-    /**
-     * Get number of unlocked achievements
-     */
-    async getUnlockedAchievementCount() {
-        return this.achievementManager.getUnlockedAchievementCount();
-    }
     /**
      * Run Steam callbacks to process pending events
      */
@@ -100,197 +74,6 @@ class SteamworksSDK {
     isSteamRunning() {
         return this.apiCore.isSteamRunning();
     }
-    // ===== VISUAL & UI FEATURES =====
-    /**
-     * Get achievement icon handle for use with ISteamUtils::GetImageRGBA()
-     */
-    async getAchievementIcon(achievementName) {
-        return this.achievementManager.getAchievementIcon(achievementName);
-    }
-    /**
-     * Show achievement progress notification in Steam overlay
-     */
-    async indicateAchievementProgress(achievementName, currentProgress, maxProgress) {
-        return this.achievementManager.indicateAchievementProgress(achievementName, currentProgress, maxProgress);
-    }
-    /**
-     * Get all achievements with icon handles
-     */
-    async getAllAchievementsWithIcons() {
-        return this.achievementManager.getAllAchievementsWithIcons();
-    }
-    // ===== PROGRESS TRACKING =====
-    /**
-     * Get achievement progress limits (integer-based)
-     */
-    async getAchievementProgressLimitsInt(achievementName) {
-        return this.achievementManager.getAchievementProgressLimitsInt(achievementName);
-    }
-    /**
-     * Get achievement progress limits (float-based)
-     */
-    async getAchievementProgressLimitsFloat(achievementName) {
-        return this.achievementManager.getAchievementProgressLimitsFloat(achievementName);
-    }
-    // ===== FRIEND/USER ACHIEVEMENTS =====
-    /**
-     * Request achievement stats for another user (friend)
-     * This is async - wait for callback before calling getUserAchievement()
-     */
-    async requestUserStats(steamId) {
-        return this.achievementManager.requestUserStats(steamId);
-    }
-    /**
-     * Get achievement status for another user (friend)
-     * Must call requestUserStats() first and wait for callback
-     */
-    async getUserAchievement(steamId, achievementName) {
-        return this.achievementManager.getUserAchievement(steamId, achievementName);
-    }
-    // ===== GLOBAL STATISTICS =====
-    /**
-     * Request global achievement percentages from Steam
-     * This is async - wait for callback before calling other global stats methods
-     */
-    async requestGlobalAchievementPercentages() {
-        return this.achievementManager.requestGlobalAchievementPercentages();
-    }
-    /**
-     * Get percentage of users who unlocked a specific achievement
-     * Must call requestGlobalAchievementPercentages() first
-     */
-    async getAchievementAchievedPercent(achievementName) {
-        return this.achievementManager.getAchievementAchievedPercent(achievementName);
-    }
-    /**
-     * Get all achievements with global unlock percentages
-     * Must call requestGlobalAchievementPercentages() first
-     */
-    async getAllAchievementsWithGlobalStats() {
-        return this.achievementManager.getAllAchievementsWithGlobalStats();
-    }
-    /**
-     * Get most achieved achievement
-     */
-    async getMostAchievedAchievementInfo() {
-        return this.achievementManager.getMostAchievedAchievementInfo();
-    }
-    /**
-     * Get next most achieved achievement (iterate by popularity)
-     */
-    async getNextMostAchievedAchievementInfo(previousIterator) {
-        return this.achievementManager.getNextMostAchievedAchievementInfo(previousIterator);
-    }
-    /**
-     * Get all achievements sorted by global popularity (most achieved first)
-     * Must call requestGlobalAchievementPercentages() first
-     */
-    async getAllAchievementsSortedByPopularity() {
-        return this.achievementManager.getAllAchievementsSortedByPopularity();
-    }
-    // ===== TESTING & DEVELOPMENT =====
-    /**
-     * Reset all stats and optionally achievements
-     * WARNING: This clears ALL user stats and achievements!
-     */
-    async resetAllStats(includeAchievements = false) {
-        return this.achievementManager.resetAllStats(includeAchievements);
-    }
-    // ========================================
-    // STATS API
-    // ========================================
-    // ===== USER STATS (GET/SET) =====
-    /**
-     * Get an integer stat value
-     */
-    async getStatInt(statName) {
-        return this.statsManager.getStatInt(statName);
-    }
-    /**
-     * Get a float stat value
-     */
-    async getStatFloat(statName) {
-        return this.statsManager.getStatFloat(statName);
-    }
-    /**
-     * Set an integer stat value
-     */
-    async setStatInt(statName, value) {
-        return this.statsManager.setStatInt(statName, value);
-    }
-    /**
-     * Set a float stat value
-     */
-    async setStatFloat(statName, value) {
-        return this.statsManager.setStatFloat(statName, value);
-    }
-    /**
-     * Update an average rate stat (e.g., kills per hour, average speed)
-     */
-    async updateAvgRateStat(statName, countThisSession, sessionLength) {
-        return this.statsManager.updateAvgRateStat(statName, countThisSession, sessionLength);
-    }
-    // ===== FRIEND/USER STATS =====
-    /**
-     * Request stats for another user (friend)
-     * Must be called before getting user stats
-     */
-    async requestUserStatsForStats(steamId) {
-        return this.statsManager.requestUserStats(steamId);
-    }
-    /**
-     * Get an integer stat value for another user (friend)
-     * Must call requestUserStatsForStats() first and wait for callback
-     */
-    async getUserStatInt(steamId, statName) {
-        return this.statsManager.getUserStatInt(steamId, statName);
-    }
-    /**
-     * Get a float stat value for another user (friend)
-     * Must call requestUserStatsForStats() first and wait for callback
-     */
-    async getUserStatFloat(steamId, statName) {
-        return this.statsManager.getUserStatFloat(steamId, statName);
-    }
-    // ===== GLOBAL STATS =====
-    /**
-     * Request global stats data from Steam
-     * Must be called before getting global stats
-     * @param historyDays - Number of days of history to retrieve (0-60)
-     */
-    async requestGlobalStats(historyDays = 0) {
-        return this.statsManager.requestGlobalStats(historyDays);
-    }
-    /**
-     * Get a global stat value (int64)
-     * Must call requestGlobalStats() first and wait for callback
-     */
-    async getGlobalStatInt(statName) {
-        return this.statsManager.getGlobalStatInt(statName);
-    }
-    /**
-     * Get a global stat value (double)
-     * Must call requestGlobalStats() first and wait for callback
-     */
-    async getGlobalStatDouble(statName) {
-        return this.statsManager.getGlobalStatDouble(statName);
-    }
-    /**
-     * Get global stat history (int64)
-     * Returns daily values for the stat, with [0] being today, [1] yesterday, etc.
-     * @param days - Number of days of history to retrieve (max 60)
-     */
-    async getGlobalStatHistoryInt(statName, days = 7) {
-        return this.statsManager.getGlobalStatHistoryInt(statName, days);
-    }
-    /**
-     * Get global stat history (double)
-     * Returns daily values for the stat, with [0] being today, [1] yesterday, etc.
-     * @param days - Number of days of history to retrieve (max 60)
-     */
-    async getGlobalStatHistoryDouble(statName, days = 7) {
-        return this.statsManager.getGlobalStatHistoryDouble(statName, days);
-    }
 }
 exports.default = SteamworksSDK;
 //# sourceMappingURL=steam.js.map

package/dist/steam.js.map

@@ -1 +1 @@
-{"version":3,"file":"steam.js","sourceRoot":"","sources":["../src/steam.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"steam.js","sourceRoot":"","sources":["../src/steam.ts"],"names":[],"mappings":";;AAIA,sEAAmE;AACnE,0DAAuD;AACvD,gFAA6E;AAC7E,oEAAiE;AACjE,gFAA6E;AAE7E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,aAAa;IA0GjB;QACE,8BAA8B;QAC9B,IAAI,CAAC,aAAa,GAAG,IAAI,uCAAkB,EAAE,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,IAAI,2BAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEpD,6BAA6B;QAC7B,IAAI,CAAC,YAAY,GAAG,IAAI,iDAAuB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAClF,IAAI,CAAC,KAAK,GAAG,IAAI,qCAAiB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC,YAAY,GAAG,IAAI,iDAAuB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpF,CAAC;IAED,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,2CAA2C;IAC3C,mBAAmB;IACnB,2CAA2C;IAE3C;;OAEG;IACH,IAAI,CAAC,OAAyB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;IACvC,CAAC;CACF;AAED,kBAAe,aAAa,CAAC"}

package/dist/{types.d.ts → types/achievements.d.ts}

@@ -1,3 +1,9 @@
+/**
+ * Achievement-related types for the SteamAchievementManager
+ */
+/**
+ * Steam achievement data
+ */
 export interface SteamAchievement {
     apiName: string;
     displayName: string;
@@ -6,18 +12,16 @@ export interface SteamAchievement {
     unlockTime: number;
     hidden?: boolean;
 }
-export interface SteamInitOptions {
-    appId: number;
-}
-export interface SteamStatus {
-    initialized: boolean;
-    appId: number;
-    steamId: string;
-}
+/**
+ * Achievement progress limits for progress tracking
+ */
 export interface AchievementProgressLimits {
     minProgress: number;
     maxProgress: number;
 }
+/**
+ * User (friend) achievement data
+ */
 export interface UserAchievement {
     steamId: string;
     apiName: string;
@@ -26,6 +30,9 @@ export interface UserAchievement {
     unlocked: boolean;
     unlockTime: number;
 }
+/**
+ * Global achievement statistics with unlock percentage
+ */
 export interface AchievementGlobalStats {
     apiName: string;
     displayName: string;
@@ -33,28 +40,10 @@ export interface AchievementGlobalStats {
     unlocked: boolean;
     globalUnlockPercentage: number;
 }
+/**
+ * Achievement with icon handle for visual display
+ */
 export interface AchievementWithIcon extends SteamAchievement {
     iconHandle: number;
 }
-export interface SteamStat {
-    name: string;
-    value: number;
-    type: 'int' | 'float';
-}
-export interface GlobalStat {
-    name: string;
-    value: number;
-    type: 'int64' | 'double';
-}
-export interface GlobalStatHistory {
-    name: string;
-    history: number[];
-    type: 'int64' | 'double';
-}
-export interface UserStat {
-    steamId: string;
-    name: string;
-    value: number;
-    type: 'int' | 'float';
-}
-//# sourceMappingURL=types.d.ts.map
+//# sourceMappingURL=achievements.d.ts.map

package/dist/types/achievements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"achievements.d.ts","sourceRoot":"","sources":["../../src/types/achievements.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,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;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,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;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/achievements.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Achievement-related types for the SteamAchievementManager
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=achievements.js.map

package/dist/types/achievements.js.map

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

package/dist/types/core.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Core Steam API types used across all managers
+ */
+/**
+ * Options for initializing the Steam API
+ */
+export interface SteamInitOptions {
+    appId: number;
+}
+/**
+ * Current Steam connection status
+ */
+export interface SteamStatus {
+    initialized: boolean;
+    appId: number;
+    steamId: string;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/types/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/core.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Core Steam API types used across all managers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=core.js.map

package/dist/types/core.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Central export file for all Steam types
+ *
+ * Types are organized by manager:
+ * - core.ts - Core Steam API types
+ * - achievements.ts - Achievement-related types
+ * - stats.ts - Stats-related types
+ * - leaderboards.ts - Leaderboard-related types
+ */
+export * from './core';
+export * from './achievements';
+export * from './stats';
+export * from './leaderboards';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,QAAQ,CAAC;AAGvB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Central export file for all Steam types
+ *
+ * Types are organized by manager:
+ * - core.ts - Core Steam API types
+ * - achievements.ts - Achievement-related types
+ * - stats.ts - Stats-related types
+ * - leaderboards.ts - Leaderboard-related types
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Core types
+__exportStar(require("./core"), exports);
+// Achievement types
+__exportStar(require("./achievements"), exports);
+// Stats types
+__exportStar(require("./stats"), exports);
+// Leaderboard types
+__exportStar(require("./leaderboards"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;AAEH,aAAa;AACb,yCAAuB;AAEvB,oBAAoB;AACpB,iDAA+B;AAE/B,cAAc;AACd,0CAAwB;AAExB,oBAAoB;AACpB,iDAA+B"}

package/dist/types/leaderboards.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Leaderboard-related types for the SteamLeaderboardManager
+ */
+/**
+ * Leaderboard sort methods
+ */
+export declare enum LeaderboardSortMethod {
+    None = 0,
+    Ascending = 1,// Top score is lowest number
+    Descending = 2
+}
+/**
+ * Leaderboard display types
+ */
+export declare enum LeaderboardDisplayType {
+    None = 0,
+    Numeric = 1,// Simple numerical score
+    TimeSeconds = 2,// Score represents time in seconds
+    TimeMilliseconds = 3
+}
+/**
+ * Leaderboard data request types
+ */
+export declare enum LeaderboardDataRequest {
+    Global = 0,// Top entries from full leaderboard
+    GlobalAroundUser = 1,// Entries around current user
+    Friends = 2,// Entries for friends only
+    Users = 3
+}
+/**
+ * Leaderboard upload score methods
+ */
+export declare enum LeaderboardUploadScoreMethod {
+    None = 0,
+    KeepBest = 1,// Keep user's best score
+    ForceUpdate = 2
+}
+/**
+ * Single leaderboard entry
+ */
+export interface LeaderboardEntry {
+    steamId: string;
+    globalRank: number;
+    score: number;
+    details: number[];
+    ugcHandle: bigint;
+}
+/**
+ * Leaderboard information
+ */
+export interface LeaderboardInfo {
+    handle: bigint;
+    name: string;
+    entryCount: number;
+    sortMethod: LeaderboardSortMethod;
+    displayType: LeaderboardDisplayType;
+}
+/**
+ * Result of score upload
+ */
+export interface LeaderboardScoreUploadResult {
+    success: boolean;
+    leaderboardHandle: bigint;
+    score: number;
+    scoreChanged: boolean;
+    globalRankNew: number;
+    globalRankPrevious: number;
+}
+/**
+ * LeaderboardFindResult_t - Result of FindOrCreateLeaderboard/FindLeaderboard
+ * Callback ID: k_iSteamUserStatsCallbacks + 4 = 1104
+ * @internal
+ */
+export interface LeaderboardFindResultType {
+    m_hSteamLeaderboard: bigint;
+    m_bLeaderboardFound: number;
+}
+/**
+ * LeaderboardScoreUploaded_t - Result of UploadLeaderboardScore
+ * Callback ID: k_iSteamUserStatsCallbacks + 6 = 1106
+ * @internal
+ */
+export interface LeaderboardScoreUploadedType {
+    m_bSuccess: number;
+    m_hSteamLeaderboard: bigint;
+    m_nScore: number;
+    m_bScoreChanged: number;
+    m_nGlobalRankNew: number;
+    m_nGlobalRankPrevious: number;
+}
+/**
+ * LeaderboardScoresDownloaded_t - Result of DownloadLeaderboardEntries
+ * Callback ID: k_iSteamUserStatsCallbacks + 5 = 1105
+ * @internal
+ */
+export interface LeaderboardScoresDownloadedType {
+    m_hSteamLeaderboard: bigint;
+    m_hSteamLeaderboardEntries: bigint;
+    m_cEntryCount: number;
+}
+/**
+ * LeaderboardUGCSet_t - Result of AttachLeaderboardUGC
+ * Callback ID: k_iSteamUserStatsCallbacks + 11 = 1111
+ * @internal
+ */
+export interface LeaderboardUGCSetType {
+    m_eResult: number;
+    m_hSteamLeaderboard: bigint;
+}
+/**
+ * LeaderboardEntry_t - Individual leaderboard entry data (from Steam)
+ * @internal
+ */
+export interface LeaderboardEntryType {
+    m_steamIDUser: bigint;
+    m_nGlobalRank: number;
+    m_nScore: number;
+    m_cDetails: number;
+    m_hUGC: bigint;
+}
+//# sourceMappingURL=leaderboards.d.ts.map

package/dist/types/leaderboards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboards.d.ts","sourceRoot":"","sources":["../../src/types/leaderboards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,oBAAY,qBAAqB;IAC/B,IAAI,IAAI;IACR,SAAS,IAAI,CAAI,6BAA6B;IAC9C,UAAU,IAAI;CACf;AAED;;GAEG;AACH,oBAAY,sBAAsB;IAChC,IAAI,IAAI;IACR,OAAO,IAAI,CAAY,yBAAyB;IAChD,WAAW,IAAI,CAAQ,mCAAmC;IAC1D,gBAAgB,IAAI;CACrB;AAED;;GAEG;AACH,oBAAY,sBAAsB;IAChC,MAAM,IAAI,CAAa,oCAAoC;IAC3D,gBAAgB,IAAI,CAAG,8BAA8B;IACrD,OAAO,IAAI,CAAY,2BAA2B;IAClD,KAAK,IAAI;CACV;AAED;;GAEG;AACH,oBAAY,4BAA4B;IACtC,IAAI,IAAI;IACR,QAAQ,IAAI,CAAO,yBAAyB;IAC5C,WAAW,IAAI;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,qBAAqB,CAAC;IAClC,WAAW,EAAE,sBAAsB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0BAA0B,EAAE,MAAM,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/leaderboards.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Leaderboard-related types for the SteamLeaderboardManager
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeaderboardUploadScoreMethod = exports.LeaderboardDataRequest = exports.LeaderboardDisplayType = exports.LeaderboardSortMethod = void 0;
+/**
+ * Leaderboard sort methods
+ */
+var LeaderboardSortMethod;
+(function (LeaderboardSortMethod) {
+    LeaderboardSortMethod[LeaderboardSortMethod["None"] = 0] = "None";
+    LeaderboardSortMethod[LeaderboardSortMethod["Ascending"] = 1] = "Ascending";
+    LeaderboardSortMethod[LeaderboardSortMethod["Descending"] = 2] = "Descending"; // Top score is highest number
+})(LeaderboardSortMethod || (exports.LeaderboardSortMethod = LeaderboardSortMethod = {}));
+/**
+ * Leaderboard display types
+ */
+var LeaderboardDisplayType;
+(function (LeaderboardDisplayType) {
+    LeaderboardDisplayType[LeaderboardDisplayType["None"] = 0] = "None";
+    LeaderboardDisplayType[LeaderboardDisplayType["Numeric"] = 1] = "Numeric";
+    LeaderboardDisplayType[LeaderboardDisplayType["TimeSeconds"] = 2] = "TimeSeconds";
+    LeaderboardDisplayType[LeaderboardDisplayType["TimeMilliseconds"] = 3] = "TimeMilliseconds"; // Score represents time in milliseconds
+})(LeaderboardDisplayType || (exports.LeaderboardDisplayType = LeaderboardDisplayType = {}));
+/**
+ * Leaderboard data request types
+ */
+var LeaderboardDataRequest;
+(function (LeaderboardDataRequest) {
+    LeaderboardDataRequest[LeaderboardDataRequest["Global"] = 0] = "Global";
+    LeaderboardDataRequest[LeaderboardDataRequest["GlobalAroundUser"] = 1] = "GlobalAroundUser";
+    LeaderboardDataRequest[LeaderboardDataRequest["Friends"] = 2] = "Friends";
+    LeaderboardDataRequest[LeaderboardDataRequest["Users"] = 3] = "Users"; // Entries for specific users
+})(LeaderboardDataRequest || (exports.LeaderboardDataRequest = LeaderboardDataRequest = {}));
+/**
+ * Leaderboard upload score methods
+ */
+var LeaderboardUploadScoreMethod;
+(function (LeaderboardUploadScoreMethod) {
+    LeaderboardUploadScoreMethod[LeaderboardUploadScoreMethod["None"] = 0] = "None";
+    LeaderboardUploadScoreMethod[LeaderboardUploadScoreMethod["KeepBest"] = 1] = "KeepBest";
+    LeaderboardUploadScoreMethod[LeaderboardUploadScoreMethod["ForceUpdate"] = 2] = "ForceUpdate"; // Always replace with new score
+})(LeaderboardUploadScoreMethod || (exports.LeaderboardUploadScoreMethod = LeaderboardUploadScoreMethod = {}));
+//# sourceMappingURL=leaderboards.js.map