@yaelouuu/fortnite-api 1.2.1 → 1.3.1

package/README.md

@@ -8,6 +8,10 @@ JavaScript/TypeScript SDK for the Fortnite API by Royal Arena.
 npm install @yaelouuu/fortnite-api
 ```
 
+## API Key
+
+Acquire your API Key by creating a Free Account here : https://api-fortnite.com
+
 ## Quick Start
 
 ```typescript

package/dist/resources/tournaments.d.ts

@@ -1,5 +1,5 @@
 import { FortniteAPI } from "../client";
-import { Leaderboard } from "../types";
+import { Leaderboard, TournamentTrackerResponse, TournamentEligibilityResponse } from "../types";
 export declare class TournamentsResource {
     private client;
     constructor(client: FortniteAPI);
@@ -28,4 +28,22 @@ export declare class TournamentsResource {
         page?: number;
         leaderboardDef?: string;
     }): Promise<Leaderboard>;
+    /**
+     * Get tournament participation history for a player
+     * GET /tournament-tracker
+     * @param accountId - Epic Games Account ID
+     * @param fortniteToken - User's Fortnite access token (from OAuth flow)
+     */
+    getTracker(accountId: string, fortniteToken: string): Promise<TournamentTrackerResponse>;
+    /**
+     * Check if a player is eligible for major tournaments
+     * GET /tournament-eligibility
+     * @param accountId - Epic Games Account ID
+     * @param fortniteToken - User's Fortnite access token (from OAuth flow)
+     * @param options - Optional configuration for eligibility check
+     */
+    checkEligibility(accountId: string, fortniteToken: string, options?: {
+        days?: number;
+        requiredTournaments?: number;
+    }): Promise<TournamentEligibilityResponse>;
 }

package/dist/resources/tournaments.js

@@ -42,5 +42,39 @@ class TournamentsResource {
         }).toString();
         return this.client.request(`/events/leaderboard?${query}`);
     }
+    /**
+     * Get tournament participation history for a player
+     * GET /tournament-tracker
+     * @param accountId - Epic Games Account ID
+     * @param fortniteToken - User's Fortnite access token (from OAuth flow)
+     */
+    async getTracker(accountId, fortniteToken) {
+        return this.client.request(`/tournament-tracker?accountId=${accountId}`, {
+            headers: {
+                "x-fortnite-token": fortniteToken,
+            },
+        });
+    }
+    /**
+     * Check if a player is eligible for major tournaments
+     * GET /tournament-eligibility
+     * @param accountId - Epic Games Account ID
+     * @param fortniteToken - User's Fortnite access token (from OAuth flow)
+     * @param options - Optional configuration for eligibility check
+     */
+    async checkEligibility(accountId, fortniteToken, options) {
+        const params = new URLSearchParams({ accountId });
+        if (options?.days) {
+            params.append("days", options.days.toString());
+        }
+        if (options?.requiredTournaments) {
+            params.append("requiredTournaments", options.requiredTournaments.toString());
+        }
+        return this.client.request(`/tournament-eligibility?${params.toString()}`, {
+            headers: {
+                "x-fortnite-token": fortniteToken,
+            },
+        });
+    }
 }
 exports.TournamentsResource = TournamentsResource;

package/dist/types/index.d.ts

@@ -106,3 +106,25 @@ export interface BatchParsingResponse {
     results?: ParsedReplayData[];
     error?: string;
 }
+export interface TournamentTrackerEntry {
+    eventWindowId: string;
+    eventName: string;
+    eventId: string;
+    beginTime: string;
+    endTime: string;
+    region: string;
+}
+export interface TournamentTrackerResponse {
+    tournaments_played: TournamentTrackerEntry[];
+    total_count: number;
+}
+export interface TournamentEligibilityResponse {
+    eligible: boolean;
+    tournaments_played: number;
+    tournaments_required: number;
+    tournaments_remaining: number;
+    calculation_period_days: number;
+    oldest_tournament_date: string | null;
+    newest_tournament_date: string | null;
+    recent_tournaments: TournamentTrackerEntry[];
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yaelouuu/fortnite-api",
-  "version": "1.2.1",
-  "description": "SDK for Fortnite Tournaments API by Royal Arena - Author : yaelouuu",
+  "version": "1.3.1",
+  "description": "SDK for Fortnite Tournaments API by Royal Arena - Author : Yael Brinkert",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -15,7 +15,7 @@
     "tournaments",
     "sdk"
   ],
-  "author": "Your Name",
+  "author": "Yael BRINKERT",
   "license": "MIT",
   "devDependencies": {
     "@types/node": "^20.0.0",