@yaelouuu/fortnite-api 6.1.0 → 6.2.0

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.1.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": {