@yaelouuu/fortnite-api 7.0.0 → 7.1.1

package/dist/resources/events.d.ts

@@ -1,44 +1,14 @@
 import { FortniteAPI } from "../client";
-import { EventWindows, PlayerEventHistory, TournamentDetails, ScoringRules, EventLeaderboard, PlayerEventData, EventRewards, PlayerTokensResponse } from "../types";
+import { EventLeaderboard, PlayerTokensResponse } from "../types";
 /**
  * Events Resource
- * Handles tournament and competitive events data
+ * Handles tournament and competitive events leaderboard data
  */
 export declare class EventsResource {
     private client;
     constructor(client: FortniteAPI);
     /**
-     * Get event windows
-     * @param eventId - Event ID
-     * @param fortniteToken - Optional user Fortnite token
-     * @returns Event windows data
-     */
-    getEventWindows(eventId: string, fortniteToken?: string): Promise<EventWindows>;
-    /**
-     * Get player event history
-     * @param accountId - Account ID
-     * @param fortniteToken - Optional user Fortnite token
-     * @returns Array of events player participated in
-     */
-    getPlayerHistory(accountId: string, fortniteToken?: string): Promise<PlayerEventHistory[]>;
-    /**
-     * Get tournament details
-     * @param eventId - Event ID
-     * @param eventWindowId - Event window ID
-     * @param fortniteToken - Optional user Fortnite token
-     * @returns Tournament details
-     */
-    getTournamentDetails(eventId: string, eventWindowId: string, fortniteToken?: string): Promise<TournamentDetails>;
-    /**
-     * Get event scoring rules
-     * @param eventId - Event ID
-     * @param eventWindowId - Event window ID
-     * @param fortniteToken - Optional user Fortnite token
-     * @returns Scoring rules
-     */
-    getScoringRules(eventId: string, eventWindowId: string, fortniteToken?: string): Promise<ScoringRules>;
-    /**
-     * Get event leaderboard
+     * Get the paginated leaderboard for a specific event window
      * @param eventId - Event ID
      * @param eventWindowId - Event window ID
      * @param options - Query options
@@ -47,16 +17,16 @@ export declare class EventsResource {
      */
     getLeaderboard(eventId: string, eventWindowId: string, options?: {
         page?: number;
+        leaderboardDef?: string;
     }, fortniteToken?: string): Promise<EventLeaderboard>;
     /**
-     * Get player event data
+     * Find a player's rank and surrounding entries in an event window leaderboard.
+     * Works for any placement including beyond top 10k. No user token required.
      * @param eventId - Event ID
      * @param eventWindowId - Event window ID
-     * @param accountId - Account ID
-     * @param fortniteToken - Optional user Fortnite token
-     * @returns Player's event performance data
+     * @param accountId - Epic account ID of the player to look up
      */
-    getPlayerEventData(eventId: string, eventWindowId: string, accountId: string, fortniteToken?: string): Promise<PlayerEventData>;
+    getPlayerLeaderboard(eventId: string, eventWindowId: string, accountId: string): Promise<EventLeaderboard>;
     /**
      * Get the raw token set for one or more players.
      * Tokens are eligibility flags earned by participating in tournaments
@@ -65,12 +35,4 @@ export declare class EventsResource {
      * @param accountIds - One or more Epic account IDs
      */
     getPlayerTokens(accountIds: string | string[]): Promise<PlayerTokensResponse>;
-    /**
-     * Get event rewards/prizes
-     * @param eventId - Event ID
-     * @param eventWindowId - Event window ID
-     * @param fortniteToken - Optional user Fortnite token
-     * @returns Event rewards structure
-     */
-    getEventRewards(eventId: string, eventWindowId: string, fortniteToken?: string): Promise<EventRewards>;
 }

package/dist/resources/events.js

@@ -3,68 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventsResource = void 0;
 /**
  * Events Resource
- * Handles tournament and competitive events data
+ * Handles tournament and competitive events leaderboard data
  */
 class EventsResource {
     constructor(client) {
         this.client = client;
     }
     /**
-     * Get event windows
-     * @param eventId - Event ID
-     * @param fortniteToken - Optional user Fortnite token
-     * @returns Event windows data
-     */
-    async getEventWindows(eventId, fortniteToken) {
-        const headers = {};
-        if (fortniteToken) {
-            headers["x-fortnite-token"] = fortniteToken;
-        }
-        return this.client.request(`/events/${eventId}/windows`, { headers }, "v2");
-    }
-    /**
-     * Get player event history
-     * @param accountId - Account ID
-     * @param fortniteToken - Optional user Fortnite token
-     * @returns Array of events player participated in
-     */
-    async getPlayerHistory(accountId, fortniteToken) {
-        const headers = {};
-        if (fortniteToken) {
-            headers["x-fortnite-token"] = fortniteToken;
-        }
-        return this.client.request(`/events/history/${accountId}`, { headers }, "v2");
-    }
-    /**
-     * Get tournament details
-     * @param eventId - Event ID
-     * @param eventWindowId - Event window ID
-     * @param fortniteToken - Optional user Fortnite token
-     * @returns Tournament details
-     */
-    async getTournamentDetails(eventId, eventWindowId, fortniteToken) {
-        const headers = {};
-        if (fortniteToken) {
-            headers["x-fortnite-token"] = fortniteToken;
-        }
-        return this.client.request(`/events/${eventId}/windows/${eventWindowId}`, { headers }, "v2");
-    }
-    /**
-     * Get event scoring rules
-     * @param eventId - Event ID
-     * @param eventWindowId - Event window ID
-     * @param fortniteToken - Optional user Fortnite token
-     * @returns Scoring rules
-     */
-    async getScoringRules(eventId, eventWindowId, fortniteToken) {
-        const headers = {};
-        if (fortniteToken) {
-            headers["x-fortnite-token"] = fortniteToken;
-        }
-        return this.client.request(`/events/${eventId}/windows/${eventWindowId}/scoring`, { headers }, "v2");
-    }
-    /**
-     * Get event leaderboard
+     * Get the paginated leaderboard for a specific event window
      * @param eventId - Event ID
      * @param eventWindowId - Event window ID
      * @param options - Query options
@@ -76,23 +22,23 @@ class EventsResource {
         if (fortniteToken) {
             headers["x-fortnite-token"] = fortniteToken;
         }
-        const query = options?.page ? `?page=${options.page}` : "";
-        return this.client.request(`/events/${eventId}/windows/${eventWindowId}/leaderboard${query}`, { headers }, "v2");
+        const params = new URLSearchParams();
+        if (options?.page != null)
+            params.append("page", String(options.page));
+        if (options?.leaderboardDef)
+            params.append("leaderboardDef", options.leaderboardDef);
+        const qs = params.toString();
+        return this.client.request(`/events/${eventId}/windows/${eventWindowId}/leaderboard${qs ? `?${qs}` : ""}`, { headers }, "v2");
     }
     /**
-     * Get player event data
+     * Find a player's rank and surrounding entries in an event window leaderboard.
+     * Works for any placement including beyond top 10k. No user token required.
      * @param eventId - Event ID
      * @param eventWindowId - Event window ID
-     * @param accountId - Account ID
-     * @param fortniteToken - Optional user Fortnite token
-     * @returns Player's event performance data
+     * @param accountId - Epic account ID of the player to look up
      */
-    async getPlayerEventData(eventId, eventWindowId, accountId, fortniteToken) {
-        const headers = {};
-        if (fortniteToken) {
-            headers["x-fortnite-token"] = fortniteToken;
-        }
-        return this.client.request(`/events/${eventId}/windows/${eventWindowId}/players/${accountId}`, { headers }, "v2");
+    async getPlayerLeaderboard(eventId, eventWindowId, accountId) {
+        return this.client.request(`/events/${eventId}/windows/${eventWindowId}/leaderboard/player?accountId=${encodeURIComponent(accountId)}`, {}, "v2");
     }
     /**
      * Get the raw token set for one or more players.
@@ -106,19 +52,5 @@ class EventsResource {
         const qs = ids.map(encodeURIComponent).join("%2C");
         return this.client.request(`/events/tokens?teamAccountIds=${qs}`, {}, "v1");
     }
-    /**
-     * Get event rewards/prizes
-     * @param eventId - Event ID
-     * @param eventWindowId - Event window ID
-     * @param fortniteToken - Optional user Fortnite token
-     * @returns Event rewards structure
-     */
-    async getEventRewards(eventId, eventWindowId, fortniteToken) {
-        const headers = {};
-        if (fortniteToken) {
-            headers["x-fortnite-token"] = fortniteToken;
-        }
-        return this.client.request(`/events/${eventId}/windows/${eventWindowId}/rewards`, { headers }, "v2");
-    }
 }
 exports.EventsResource = EventsResource;

package/dist/resources/profiles.d.ts

@@ -18,9 +18,14 @@ export declare class ProfilesResource {
     getLevel(accountId: string, fortniteToken: string): Promise<ProfileLevel>;
     /**
      * Get enriched ranked progress — human-readable rank names, game mode labels, season dates.
-     * @param displayName - Epic Games display name
+     * Accepts either a display name or an account ID. Account ID is preferred: it is faster
+     * (skips the name→ID lookup) and is not affected by display name changes.
+     * @param displayName - Epic Games display name (ignored if accountId is provided)
+     * @param options - Optional: pass `accountId` to bypass the name lookup
      */
-    getRanked(displayName: string): Promise<RankedProgress[]>;
+    getRanked(displayName: string, options?: {
+        accountId?: string;
+    }): Promise<RankedProgress[]>;
     /**
      * Get all available ranked game mode tracks — modes, division counts, and season dates.
      * @param options - Optional filters

package/dist/resources/profiles.js

@@ -24,10 +24,20 @@ class ProfilesResource {
     }
     /**
      * Get enriched ranked progress — human-readable rank names, game mode labels, season dates.
-     * @param displayName - Epic Games display name
+     * Accepts either a display name or an account ID. Account ID is preferred: it is faster
+     * (skips the name→ID lookup) and is not affected by display name changes.
+     * @param displayName - Epic Games display name (ignored if accountId is provided)
+     * @param options - Optional: pass `accountId` to bypass the name lookup
      */
-    async getRanked(displayName) {
-        return this.client.request(`/profile/ranked?displayName=${encodeURIComponent(displayName)}`);
+    async getRanked(displayName, options) {
+        const params = new URLSearchParams();
+        if (options?.accountId) {
+            params.append("accountId", options.accountId);
+        }
+        else {
+            params.append("displayName", displayName);
+        }
+        return this.client.request(`/profile/ranked?${params.toString()}`);
     }
     /**
      * Get all available ranked game mode tracks — modes, division counts, and season dates.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaelouuu/fortnite-api",
-  "version": "7.0.0",
+  "version": "7.1.1",
   "description": "SDK for Fortnite API - api-fortnite.com - Author : Yael Brinkert",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",