@yaelouuu/fortnite-api 6.0.0 → 6.2.0

package/dist/resources/account.d.ts

@@ -51,4 +51,9 @@ export declare class AccountResource {
      * @param fortniteToken - Optional user Fortnite token
      */
     getExternalAuth(accountId: string, platform: string, fortniteToken?: string): Promise<ExternalAuth>;
+    /**
+     * Resolve one or more Epic account IDs to their display names
+     * @param accountIds - Array of Epic Games account IDs (comma-separated, max 100)
+     */
+    getDisplayNames(accountIds: string[]): Promise<Account[]>;
 }

package/dist/resources/account.js

@@ -99,5 +99,13 @@ class AccountResource {
         }
         return this.client.request(`/account/${accountId}/externalAuths/${platform}`, { headers }, "v1");
     }
+    /**
+     * Resolve one or more Epic account IDs to their display names
+     * @param accountIds - Array of Epic Games account IDs (comma-separated, max 100)
+     */
+    async getDisplayNames(accountIds) {
+        const ids = accountIds.join(",");
+        return this.client.request(`/account/displaynames?ids=${encodeURIComponent(ids)}`, {}, "v1");
+    }
 }
 exports.AccountResource = AccountResource;

package/dist/resources/profiles.d.ts

@@ -1,27 +1,15 @@
 import { FortniteAPI } from "../client";
-import { Profile, ProfileStats } from "../types";
 export declare class ProfilesResource {
     private client;
     constructor(client: FortniteAPI);
     /**
-     * Get profile progress (ranked divisions, levels) by display name
+     * Get profile progress (track progress, levels) by display name
      * @param displayName - Epic Games display name
      */
     getProgress(displayName: string): Promise<any>;
     /**
-     * Get profile stats by display name
+     * Get enriched ranked progress by display name (human-readable ranks, game modes, season dates)
      * @param displayName - Epic Games display name
-     * @param timeWindow - Time period: "season" or "lifetime" (default: "lifetime")
      */
-    getStats(displayName: string, timeWindow?: "season" | "lifetime"): Promise<ProfileStats>;
-    /**
-     * Get account info by ID
-     * @param accountId - Epic Games Account ID
-     */
-    getAccount(accountId: string): Promise<Profile>;
-    /**
-     * Get multiple display names by account IDs
-     * @param accountIds - Array of account IDs (max 100)
-     */
-    getDisplayNames(accountIds: string[]): Promise<Record<string, string>>;
+    getRanked(displayName: string): Promise<any>;
 }

package/dist/resources/profiles.js

@@ -6,39 +6,18 @@ class ProfilesResource {
         this.client = client;
     }
     /**
-     * Get profile progress (ranked divisions, levels) by display name
+     * Get profile progress (track progress, levels) by display name
      * @param displayName - Epic Games display name
      */
     async getProgress(displayName) {
         return this.client.request(`/profile/progress?displayName=${encodeURIComponent(displayName)}`);
     }
     /**
-     * Get profile stats by display name
+     * Get enriched ranked progress by display name (human-readable ranks, game modes, season dates)
      * @param displayName - Epic Games display name
-     * @param timeWindow - Time period: "season" or "lifetime" (default: "lifetime")
      */
-    async getStats(displayName, timeWindow) {
-        const params = new URLSearchParams({
-            displayName,
-        });
-        if (timeWindow)
-            params.set("timeWindow", timeWindow);
-        return this.client.request(`/profile/stats?${params.toString()}`);
-    }
-    /**
-     * Get account info by ID
-     * @param accountId - Epic Games Account ID
-     */
-    async getAccount(accountId) {
-        return this.client.request(`/account/${accountId}`);
-    }
-    /**
-     * Get multiple display names by account IDs
-     * @param accountIds - Array of account IDs (max 100)
-     */
-    async getDisplayNames(accountIds) {
-        const ids = accountIds.join(",");
-        return this.client.request(`/displaynames/multiple?ids=${encodeURIComponent(ids)}`);
+    async getRanked(displayName) {
+        return this.client.request(`/profile/ranked?displayName=${encodeURIComponent(displayName)}`);
     }
 }
 exports.ProfilesResource = ProfilesResource;

package/dist/resources/tournaments.d.ts

@@ -1,5 +1,5 @@
 import { FortniteAPI } from "../client";
-import { Leaderboard, TournamentTrackerResponse, TournamentEligibilityResponse } from "../types";
+import { Leaderboard, TournamentTrackerResponse, TournamentEligibilityResponse, EventTokenEligibilityResponse } from "../types";
 export declare class TournamentsResource {
     private client;
     constructor(client: FortniteAPI);
@@ -81,6 +81,25 @@ export declare class TournamentsResource {
         days?: number;
         requiredTournaments?: number;
     }): Promise<TournamentEligibilityResponse>;
+    /**
+     * Check a player's token eligibility for a specific event window.
+     *
+     * Verifies all token requirements (requireAllTokens, requireAnyTokens,
+     * requireNoneTokensCaller, etc.) using the Epic tokens endpoint — no player
+     * auth needed. Hardware/system requirements and MFA are always listed as
+     * unverified since they cannot be checked remotely.
+     *
+     * Accepts a display name or an Epic account ID (with or without dashes).
+     *
+     * @param identifier - Player display name or Epic account ID
+     * @param eventId - Epic event ID (e.g. `"epicgames_S40_FNCSMajor1_LCQ_EU"`)
+     * @param options.eventWindowId - Optional window ID; defaults to the most relevant window (live → upcoming → latest ended)
+     * @param options.fortniteToken - Optional user Fortnite token for future extended checks
+     */
+    checkEventEligibility(identifier: string, eventId: string, options?: {
+        eventWindowId?: string;
+        fortniteToken?: string;
+    }): Promise<EventTokenEligibilityResponse>;
     /**
      * Get tournament leaderboard using V2 endpoint (POST with teams body)
      *

package/dist/resources/tournaments.js

@@ -128,6 +128,33 @@ class TournamentsResource {
             },
         });
     }
+    /**
+     * Check a player's token eligibility for a specific event window.
+     *
+     * Verifies all token requirements (requireAllTokens, requireAnyTokens,
+     * requireNoneTokensCaller, etc.) using the Epic tokens endpoint — no player
+     * auth needed. Hardware/system requirements and MFA are always listed as
+     * unverified since they cannot be checked remotely.
+     *
+     * Accepts a display name or an Epic account ID (with or without dashes).
+     *
+     * @param identifier - Player display name or Epic account ID
+     * @param eventId - Epic event ID (e.g. `"epicgames_S40_FNCSMajor1_LCQ_EU"`)
+     * @param options.eventWindowId - Optional window ID; defaults to the most relevant window (live → upcoming → latest ended)
+     * @param options.fortniteToken - Optional user Fortnite token for future extended checks
+     */
+    async checkEventEligibility(identifier, eventId, options) {
+        const query = new URLSearchParams();
+        if (options?.eventWindowId) {
+            query.append("eventWindowId", options.eventWindowId);
+        }
+        const qs = query.toString();
+        const path = `/events/tracker/eligibility/${encodeURIComponent(identifier)}/${encodeURIComponent(eventId)}${qs ? `?${qs}` : ""}`;
+        const requestOptions = options?.fortniteToken
+            ? { headers: { "x-fortnite-token": options.fortniteToken } }
+            : undefined;
+        return this.client.request(path, requestOptions);
+    }
     /**
      * Get tournament leaderboard using V2 endpoint (POST with teams body)
      *

package/dist/types/index.d.ts

@@ -214,6 +214,36 @@ export interface TournamentEligibilityResponse {
     newest_tournament_date: string | null;
     recent_tournaments: TournamentTrackerEntry[];
 }
+export type TokenRequirementType = "mustHave" | "mustHaveAny" | "mustNotHave";
+export type TokenGroupType = "requireAllTokens" | "requireAnyTokens" | "requireNoneTokensCaller" | "requireAllTokensCaller" | "requireAnyTokensCaller";
+export interface VerifiedRequirement {
+    token: string;
+    label: string;
+    type: TokenRequirementType;
+    tokenGroup: TokenGroupType;
+    met: boolean;
+}
+export interface UnverifiedRequirement {
+    type: "accountLevel" | "systemFeature" | "mfa";
+    key: string;
+    label: string;
+    description: string;
+    /** Only present for accountLevel requirements */
+    threshold?: number;
+    /** Only present for accountLevel requirements */
+    estimatedCurrentLevel?: number | null;
+    /** Only present for accountLevel requirements */
+    estimatedMet?: boolean | null;
+}
+export interface EventTokenEligibilityResponse {
+    accountId: string;
+    displayName: string;
+    eventId: string;
+    eventWindowId: string;
+    isEligible: boolean;
+    verifiedRequirements: VerifiedRequirement[];
+    unverifiedRequirements: UnverifiedRequirement[];
+}
 export interface SeasonEntry {
     chapter: number;
     season: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yaelouuu/fortnite-api",
-  "version": "6.0.0",
-  "description": "SDK for Fortnite Tournaments API by Royal Arena - Author : Yael Brinkert",
+  "version": "6.2.0",
+  "description": "SDK for Fortnite API - api-fortnite.com - Author : Yael Brinkert",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {