steamworks-ffi-node 0.1.1 → 0.2.0

package/dist/internal/SteamAchievementManager.d.ts

@@ -0,0 +1,117 @@
+import { SteamAchievement, AchievementProgressLimits, UserAchievement, AchievementGlobalStats, AchievementWithIcon } from '../types';
+import { SteamLibraryLoader } from './SteamLibraryLoader';
+import { SteamAPICore } from './SteamAPICore';
+/**
+ * Manages all Steam achievement operations
+ */
+export declare class SteamAchievementManager {
+    private libraryLoader;
+    private apiCore;
+    constructor(libraryLoader: SteamLibraryLoader, apiCore: SteamAPICore);
+    /**
+     * Get all achievements from Steam
+     */
+    getAllAchievements(): Promise<SteamAchievement[]>;
+    /**
+     * Unlock achievement in Steam
+     */
+    unlockAchievement(achievementName: string): Promise<boolean>;
+    /**
+     * Clear achievement in Steam (for testing)
+     */
+    clearAchievement(achievementName: string): Promise<boolean>;
+    /**
+     * Check if achievement is unlocked
+     */
+    isAchievementUnlocked(achievementName: string): Promise<boolean>;
+    /**
+     * Get achievement by API name
+     */
+    getAchievementByName(achievementName: string): Promise<SteamAchievement | null>;
+    /**
+     * Get total number of achievements
+     */
+    getTotalAchievementCount(): Promise<number>;
+    /**
+     * Get number of unlocked achievements
+     */
+    getUnlockedAchievementCount(): Promise<number>;
+    /**
+     * Get achievement icon handle
+     * Returns icon handle for use with ISteamUtils::GetImageRGBA()
+     * Returns 0 if no icon set or still loading
+     */
+    getAchievementIcon(achievementName: string): Promise<number>;
+    /**
+     * Indicate achievement progress to user
+     * Shows a progress notification in Steam overlay
+     */
+    indicateAchievementProgress(achievementName: string, currentProgress: number, maxProgress: number): Promise<boolean>;
+    /**
+     * Get achievement progress limits (for integer-based progress)
+     */
+    getAchievementProgressLimitsInt(achievementName: string): Promise<AchievementProgressLimits | null>;
+    /**
+     * Get achievement progress limits (for float-based progress)
+     */
+    getAchievementProgressLimitsFloat(achievementName: string): Promise<AchievementProgressLimits | null>;
+    /**
+     * Request stats for another user (friend)
+     * This is async - you need to wait for the callback before calling getUserAchievement
+     */
+    requestUserStats(steamId: string): Promise<boolean>;
+    /**
+     * Get achievement status for another user (friend)
+     * Must call requestUserStats() first and wait for callback
+     */
+    getUserAchievement(steamId: string, achievementName: string): Promise<UserAchievement | null>;
+    /**
+     * Request global achievement percentages
+     * This is async - wait for callback before calling getAchievementAchievedPercent
+     */
+    requestGlobalAchievementPercentages(): Promise<boolean>;
+    /**
+     * Get percentage of users who unlocked a specific achievement
+     * Must call requestGlobalAchievementPercentages() first
+     */
+    getAchievementAchievedPercent(achievementName: string): Promise<number | null>;
+    /**
+     * Get all achievements with global unlock percentages
+     * Must call requestGlobalAchievementPercentages() first and wait for callback
+     */
+    getAllAchievementsWithGlobalStats(): Promise<AchievementGlobalStats[]>;
+    /**
+     * Get most achieved achievement info
+     * Returns iterator for use with getNextMostAchievedAchievementInfo
+     */
+    getMostAchievedAchievementInfo(): Promise<{
+        apiName: string;
+        percent: number;
+        unlocked: boolean;
+        iterator: number;
+    } | null>;
+    /**
+     * Get next most achieved achievement info (iterate by popularity)
+     */
+    getNextMostAchievedAchievementInfo(previousIterator: number): Promise<{
+        apiName: string;
+        percent: number;
+        unlocked: boolean;
+        iterator: number;
+    } | null>;
+    /**
+     * Get all achievements sorted by global unlock percentage (most achieved first)
+     * Must call requestGlobalAchievementPercentages() first
+     */
+    getAllAchievementsSortedByPopularity(): Promise<AchievementGlobalStats[]>;
+    /**
+     * Reset all stats and optionally achievements
+     * WARNING: This clears ALL user stats and achievements!
+     */
+    resetAllStats(includeAchievements?: boolean): Promise<boolean>;
+    /**
+     * Get all achievements with icon handles
+     */
+    getAllAchievementsWithIcons(): Promise<AchievementWithIcon[]>;
+}
+//# sourceMappingURL=SteamAchievementManager.d.ts.map

package/dist/internal/SteamAchievementManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SteamAchievementManager.d.ts","sourceRoot":"","sources":["../../src/internal/SteamAchievementManager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAe;gBAElB,aAAa,EAAE,kBAAkB,EAAE,OAAO,EAAE,YAAY;IAKpE;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAoEvD;;OAEG;IACG,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2ClE;;OAEG;IACG,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2CjE;;OAEG;IACG,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBtE;;OAEG;IACG,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKrF;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBjD;;OAEG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,CAAC;IAKpD;;;;OAIG;IACG,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BlE;;;OAGG;IACG,2BAA2B,CAC/B,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC;IAoCnB;;OAEG;IACG,+BAA+B,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAqCzG;;OAEG;IACG,iCAAiC,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAqC3G;;;OAGG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkCzD;;;OAGG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAuDnG;;;OAGG;IACG,mCAAmC,IAAI,OAAO,CAAC,OAAO,CAAC;IAgC7D;;;OAGG;IACG,6BAA6B,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkCpF;;;OAGG;IACG,iCAAiC,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAmB5E;;;OAGG;IACG,8BAA8B,IAAI,OAAO,CAAC;QAC9C,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAA;KACjB,GAAG,IAAI,CAAC;IAwCT;;OAEG;IACG,kCAAkC,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1E,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAA;KACjB,GAAG,IAAI,CAAC;IAyCT;;;OAGG;IACG,oCAAoC,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IA4D/E;;;OAGG;IACG,aAAa,CAAC,mBAAmB,GAAE,OAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IA2C3E;;OAEG;IACG,2BAA2B,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAepE"}