@yaelouuu/fortnite-api 7.1.1 → 8.0.0

package/dist/client.d.ts

@@ -5,6 +5,7 @@ import { CalendarResource } from "./resources/calendar";
 import { BundlesResource } from "./resources/bundles";
 import { OauthResource } from "./resources/oauth";
 import { ParsingResource } from "./resources/parsing";
+import { ReplaysResource } from "./resources/replays";
 import { WeaponsResource } from "./resources/weapons";
 import { BattlePassResource } from "./resources/battlepass";
 import { QuestsResource } from "./resources/quests";
@@ -32,6 +33,7 @@ export declare class FortniteAPI {
     bundles: BundlesResource;
     oauth: OauthResource;
     parsing: ParsingResource;
+    replays: ReplaysResource;
     weapons: WeaponsResource;
     battlepass: BattlePassResource;
     quests: QuestsResource;
@@ -50,6 +52,10 @@ export declare class FortniteAPI {
      * Internal method to make HTTP requests
      */
     request<T>(endpoint: string, options?: RequestInit, version?: "v1" | "v2"): Promise<T>;
+    /**
+     * Internal method for binary (application/octet-stream) downloads
+     */
+    requestBinary(endpoint: string, version?: "v1" | "v2"): Promise<ArrayBuffer>;
     /**
      * Internal method for multipart/form-data requests (file uploads)
      */

package/dist/client.js

@@ -9,6 +9,7 @@ const errors_1 = require("./errors");
 const bundles_1 = require("./resources/bundles");
 const oauth_1 = require("./resources/oauth");
 const parsing_1 = require("./resources/parsing");
+const replays_1 = require("./resources/replays");
 const weapons_1 = require("./resources/weapons");
 const battlepass_1 = require("./resources/battlepass");
 const quests_1 = require("./resources/quests");
@@ -35,6 +36,7 @@ class FortniteAPI {
         this.bundles = new bundles_1.BundlesResource(this);
         this.oauth = new oauth_1.OauthResource(this);
         this.parsing = new parsing_1.ParsingResource(this);
+        this.replays = new replays_1.ReplaysResource(this);
         this.weapons = new weapons_1.WeaponsResource(this);
         this.battlepass = new battlepass_1.BattlePassResource(this);
         this.quests = new quests_1.QuestsResource(this);
@@ -75,6 +77,28 @@ class FortniteAPI {
         const data = await response.json();
         return data;
     }
+    /**
+     * Internal method for binary (application/octet-stream) downloads
+     */
+    async requestBinary(endpoint, version = "v1") {
+        const url = `${this.baseUrl}/${version}${endpoint}`;
+        const response = await fetch(url, {
+            headers: {
+                "x-api-key": this.apiKey,
+            },
+        });
+        if (!response.ok) {
+            let errorData;
+            try {
+                errorData = await response.json();
+            }
+            catch {
+                errorData = { error: "Request failed" };
+            }
+            throw new errors_1.FortniteAPIError(errorData.error || `Request failed with status ${response.status}`, response.status, errorData);
+        }
+        return response.arrayBuffer();
+    }
     /**
      * Internal method for multipart/form-data requests (file uploads)
      */

package/dist/resources/account.d.ts

@@ -56,4 +56,10 @@ export declare class AccountResource {
      * @param accountIds - Array of Epic Games account IDs (comma-separated, max 100)
      */
     getDisplayNames(accountIds: string[]): Promise<Account[]>;
+    /**
+     * Epic ID SDK v2 lookup — returns extended account info via the Developer Portal API.
+     * Accepts one or more Epic account IDs.
+     * @param accountIds - One or more Epic account IDs (comma-separated)
+     */
+    getEpicIdSdkAccounts(accountIds: string | string[]): Promise<any[]>;
 }

package/dist/resources/account.js

@@ -107,5 +107,14 @@ class AccountResource {
         const ids = accountIds.join(",");
         return this.client.request(`/account/displaynames?ids=${encodeURIComponent(ids)}`, {}, "v1");
     }
+    /**
+     * Epic ID SDK v2 lookup — returns extended account info via the Developer Portal API.
+     * Accepts one or more Epic account IDs.
+     * @param accountIds - One or more Epic account IDs (comma-separated)
+     */
+    async getEpicIdSdkAccounts(accountIds) {
+        const ids = Array.isArray(accountIds) ? accountIds.join(",") : accountIds;
+        return this.client.request(`/account/sdk?accountId=${encodeURIComponent(ids)}`, {}, "v1");
+    }
 }
 exports.AccountResource = AccountResource;

package/dist/resources/battlepass.d.ts

@@ -4,7 +4,8 @@ export declare class BattlePassResource {
     private client;
     constructor(client: FortniteAPI);
     /**
-     * Get current battle pass items
+     * Get current Battle Pass content and rewards
+     * @param lang - Language code (default: en)
      */
-    getBattlePass(): Promise<BattlePass>;
+    getBattlePass(lang?: string): Promise<BattlePass>;
 }

package/dist/resources/battlepass.js

@@ -6,10 +6,12 @@ class BattlePassResource {
         this.client = client;
     }
     /**
-     * Get current battle pass items
+     * Get current Battle Pass content and rewards
+     * @param lang - Language code (default: en)
      */
-    async getBattlePass() {
-        return this.client.request("/shop/battlepass");
+    async getBattlePass(lang) {
+        const query = lang ? `?lang=${encodeURIComponent(lang)}` : "";
+        return this.client.request(`/shop/battlepass${query}`);
     }
 }
 exports.BattlePassResource = BattlePassResource;

package/dist/resources/bundles.d.ts

@@ -4,11 +4,11 @@ export declare class BundlesResource {
     private client;
     constructor(client: FortniteAPI);
     /**
-     * Get current season information
+     * Get tournament asset bundles (images, icons, rewards)
      */
     getBundlesTournament(): Promise<TournamentsBundle>;
     /**
-     * Get current season information
+     * Get shop asset bundles
      */
     getBundlesShop(): Promise<Shop>;
 }

package/dist/resources/bundles.js

@@ -6,13 +6,13 @@ class BundlesResource {
         this.client = client;
     }
     /**
-     * Get current season information
+     * Get tournament asset bundles (images, icons, rewards)
      */
     async getBundlesTournament() {
         return this.client.request("/assets/bundles/tournaments");
     }
     /**
-     * Get current season information
+     * Get shop asset bundles
      */
     async getBundlesShop() {
         return this.client.request("/assets/bundles/shop");

package/dist/resources/cosmetics.d.ts

@@ -5,21 +5,32 @@ export declare class CosmeticsResource {
     constructor(client: FortniteAPI);
     /**
      * Get all cosmetics with pagination and filters
+     * @param params.lang - Language code (default: en)
      */
-    getAll(params?: CosmeticsSearchParams): Promise<CosmeticsPaginatedResponse>;
+    getAll(params?: CosmeticsSearchParams & {
+        lang?: string;
+    }): Promise<CosmeticsPaginatedResponse>;
     /**
      * Get a specific cosmetic by ID
+     * @param id - Cosmetic ID
+     * @param lang - Language code (default: en)
      */
-    getById(id: string): Promise<CosmeticsResponse<CosmeticItem>>;
+    getById(id: string, lang?: string): Promise<CosmeticsResponse<CosmeticItem>>;
     /**
      * Search cosmetics by name or description
+     * @param query - Search term
+     * @param params.lang - Language code (default: en)
      */
-    search(query: string, params?: Omit<CosmeticsSearchParams, 'search'>): Promise<CosmeticsPaginatedResponse>;
+    search(query: string, params?: Omit<CosmeticsSearchParams, 'search'> & {
+        lang?: string;
+    }): Promise<CosmeticsPaginatedResponse>;
     /**
      * Get recently added cosmetics
+     * @param params.lang - Language code (default: en)
      */
     getNew(params?: {
         page?: number;
         pageSize?: number;
+        lang?: string;
     }): Promise<CosmeticsPaginatedResponse>;
 }

package/dist/resources/cosmetics.js

@@ -7,6 +7,7 @@ class CosmeticsResource {
     }
     /**
      * Get all cosmetics with pagination and filters
+     * @param params.lang - Language code (default: en)
      */
     async getAll(params) {
         const queryParams = new URLSearchParams();
@@ -26,18 +27,25 @@ class CosmeticsResource {
             queryParams.set("season", params.season.toString());
         if (params?.chapter)
             queryParams.set("chapter", params.chapter.toString());
+        if (params?.lang)
+            queryParams.set("lang", params.lang);
         const query = queryParams.toString();
         const endpoint = query ? `/cosmetics/all?${query}` : "/cosmetics/all";
-        return this.client.request(endpoint);
+        return this.client.request(endpoint, {}, "v2");
     }
     /**
      * Get a specific cosmetic by ID
+     * @param id - Cosmetic ID
+     * @param lang - Language code (default: en)
      */
-    async getById(id) {
-        return this.client.request(`/cosmetics/${id}`);
+    async getById(id, lang) {
+        const query = lang ? `?lang=${encodeURIComponent(lang)}` : "";
+        return this.client.request(`/cosmetics/${id}${query}`, {}, "v2");
     }
     /**
      * Search cosmetics by name or description
+     * @param query - Search term
+     * @param params.lang - Language code (default: en)
      */
     async search(query, params) {
         const queryParams = new URLSearchParams();
@@ -52,10 +60,13 @@ class CosmeticsResource {
             queryParams.set("rarity", params.rarity);
         if (params?.set)
             queryParams.set("set", params.set);
-        return this.client.request(`/cosmetics/search?${queryParams.toString()}`);
+        if (params?.lang)
+            queryParams.set("lang", params.lang);
+        return this.client.request(`/cosmetics/search?${queryParams.toString()}`, {}, "v2");
     }
     /**
      * Get recently added cosmetics
+     * @param params.lang - Language code (default: en)
      */
     async getNew(params) {
         const queryParams = new URLSearchParams();
@@ -63,9 +74,11 @@ class CosmeticsResource {
             queryParams.set("page", params.page.toString());
         if (params?.pageSize)
             queryParams.set("pageSize", params.pageSize.toString());
+        if (params?.lang)
+            queryParams.set("lang", params.lang);
         const query = queryParams.toString();
         const endpoint = query ? `/cosmetics/new?${query}` : "/cosmetics/new";
-        return this.client.request(endpoint);
+        return this.client.request(endpoint, {}, "v2");
     }
 }
 exports.CosmeticsResource = CosmeticsResource;

package/dist/resources/events.d.ts

@@ -1,5 +1,5 @@
 import { FortniteAPI } from "../client";
-import { EventLeaderboard, PlayerTokensResponse } from "../types";
+import { EventLeaderboard, PlayerTokensResponse, PlayerWindowStanding } from "../types";
 /**
  * Events Resource
  * Handles tournament and competitive events leaderboard data
@@ -27,6 +27,24 @@ export declare class EventsResource {
      * @param accountId - Epic account ID of the player to look up
      */
     getPlayerLeaderboard(eventId: string, eventWindowId: string, accountId: string): Promise<EventLeaderboard>;
+    /**
+     * Get a player's standing in a specific event window.
+     *
+     * Uses Epic's dedicated player endpoint — no leaderboard page scanning required.
+     * Returns rank, score, and full session history for the player directly.
+     * No user token required — uses service auth.
+     *
+     * @param eventId - Event identifier (e.g. `"epicgames_S40_FNCSMajor1_PlayInStage_EU"`)
+     * @param eventWindowId - Event window identifier (e.g. `"S40_FNCSMajor1_PlayInStage_Day1_EU"`)
+     * @param accountId - Epic account ID of the player
+     */
+    getPlayerWindowStanding(eventId: string, eventWindowId: string, accountId: string): Promise<PlayerWindowStanding>;
+    /**
+     * Get a player's event participation history.
+     * Uses the V2 events endpoint with service token — no user token required.
+     * @param accountId - Epic account ID of the player
+     */
+    getPlayerEventHistory(accountId: string): Promise<any>;
     /**
      * Get the raw token set for one or more players.
      * Tokens are eligibility flags earned by participating in tournaments

package/dist/resources/events.js

@@ -40,6 +40,28 @@ class EventsResource {
     async getPlayerLeaderboard(eventId, eventWindowId, accountId) {
         return this.client.request(`/events/${eventId}/windows/${eventWindowId}/leaderboard/player?accountId=${encodeURIComponent(accountId)}`, {}, "v2");
     }
+    /**
+     * Get a player's standing in a specific event window.
+     *
+     * Uses Epic's dedicated player endpoint — no leaderboard page scanning required.
+     * Returns rank, score, and full session history for the player directly.
+     * No user token required — uses service auth.
+     *
+     * @param eventId - Event identifier (e.g. `"epicgames_S40_FNCSMajor1_PlayInStage_EU"`)
+     * @param eventWindowId - Event window identifier (e.g. `"S40_FNCSMajor1_PlayInStage_Day1_EU"`)
+     * @param accountId - Epic account ID of the player
+     */
+    async getPlayerWindowStanding(eventId, eventWindowId, accountId) {
+        return this.client.request(`/events/${encodeURIComponent(eventId)}/windows/${encodeURIComponent(eventWindowId)}/players/${encodeURIComponent(accountId)}`, {}, "v2");
+    }
+    /**
+     * Get a player's event participation history.
+     * Uses the V2 events endpoint with service token — no user token required.
+     * @param accountId - Epic account ID of the player
+     */
+    async getPlayerEventHistory(accountId) {
+        return this.client.request(`/events/players/${encodeURIComponent(accountId)}/history`, {}, "v2");
+    }
     /**
      * Get the raw token set for one or more players.
      * Tokens are eligibility flags earned by participating in tournaments

package/dist/resources/fn.d.ts

@@ -24,11 +24,11 @@ export declare class FNResource {
      */
     getEnabledFeatures(): Promise<EnabledFeatures>;
     /**
-     * Check game version
-     * @param platform - Platform name (Windows, Mac, etc.)
-     * @param version - Version string to check
+     * Get the current Fortnite version for a platform, with optional version string to check against
+     * @param platform - Platform code (e.g. Windows, Android, iOS)
+     * @param version - Optional version string to check against
      */
-    checkVersion(platform: string, version: string): Promise<VersionCheck>;
+    checkVersion(platform: string, version?: string): Promise<VersionCheck>;
     /**
      * Get privacy settings for an account (requires user token)
      * @param accountId - Epic Games account ID

package/dist/resources/fn.js

@@ -42,12 +42,13 @@ class FNResource {
         return this.client.request("/fn/enabled-features", {}, "v2");
     }
     /**
-     * Check game version
-     * @param platform - Platform name (Windows, Mac, etc.)
-     * @param version - Version string to check
+     * Get the current Fortnite version for a platform, with optional version string to check against
+     * @param platform - Platform code (e.g. Windows, Android, iOS)
+     * @param version - Optional version string to check against
      */
     async checkVersion(platform, version) {
-        return this.client.request(`/fn/version/${platform}?version=${encodeURIComponent(version)}`, {}, "v2");
+        const query = version ? `?version=${encodeURIComponent(version)}` : "";
+        return this.client.request(`/fn/version/${platform}${query}`, {}, "v2");
     }
     /**
      * Get privacy settings for an account (requires user token)

package/dist/resources/map.d.ts

@@ -4,15 +4,26 @@ export declare class MapResource {
     private client;
     constructor(client: FortniteAPI);
     /**
-     * Get current Fortnite map with POIs
-     * @param version - Optional specific map version to retrieve
+     * Get a Fortnite map with its POIs and minimap metadata.
+     * @param version - Map version (patch number); defaults to the current version.
+     * @param mode - Which map to return: `br` (default), `og`, or `rotating:<codename>`.
+     *   The available values are listed in the response's `data.modes`.
+     * @param lang - Language code for POI labels (default: `en`).
+     *
+     * @example
+     * const br = await client.map.getCurrent();
+     * const og = await client.map.getCurrent(undefined, "og");
+     * const reload = await client.map.getCurrent(undefined, "rotating:blastberry");
+     * const old = await client.map.getCurrent("33.00");
      */
-    getCurrent(version?: string): Promise<MapResponse>;
+    getCurrent(version?: string, mode?: string, lang?: string): Promise<MapResponse>;
     /**
-     * Get current map image URL
-     * @param version - Optional specific map version to retrieve
+     * Get the map image (302 redirect to the raw image).
+     * Prefer reading `getCurrent().data.imageUrl`, which is the direct URL.
+     * @param version - Map version; defaults to current.
+     * @param mode - Which image: `br` (default), `og`, or `rotating:<codename>`.
      */
-    getImage(version?: string): Promise<MapImageResponse>;
+    getImage(version?: string, mode?: string): Promise<MapImageResponse>;
     /**
      * Get historical map data
      * @param options.chapter - Filter by chapter number

package/dist/resources/map.js

@@ -6,19 +6,42 @@ class MapResource {
         this.client = client;
     }
     /**
-     * Get current Fortnite map with POIs
-     * @param version - Optional specific map version to retrieve
+     * Get a Fortnite map with its POIs and minimap metadata.
+     * @param version - Map version (patch number); defaults to the current version.
+     * @param mode - Which map to return: `br` (default), `og`, or `rotating:<codename>`.
+     *   The available values are listed in the response's `data.modes`.
+     * @param lang - Language code for POI labels (default: `en`).
+     *
+     * @example
+     * const br = await client.map.getCurrent();
+     * const og = await client.map.getCurrent(undefined, "og");
+     * const reload = await client.map.getCurrent(undefined, "rotating:blastberry");
+     * const old = await client.map.getCurrent("33.00");
      */
-    async getCurrent(version) {
-        const query = version ? `?version=${encodeURIComponent(version)}` : "";
+    async getCurrent(version, mode, lang) {
+        const params = new URLSearchParams();
+        if (version)
+            params.set("version", version);
+        if (mode)
+            params.set("mode", mode);
+        if (lang)
+            params.set("lang", lang);
+        const query = params.toString() ? `?${params.toString()}` : "";
         return this.client.request(`/map${query}`);
     }
     /**
-     * Get current map image URL
-     * @param version - Optional specific map version to retrieve
+     * Get the map image (302 redirect to the raw image).
+     * Prefer reading `getCurrent().data.imageUrl`, which is the direct URL.
+     * @param version - Map version; defaults to current.
+     * @param mode - Which image: `br` (default), `og`, or `rotating:<codename>`.
      */
-    async getImage(version) {
-        const query = version ? `?version=${encodeURIComponent(version)}` : "";
+    async getImage(version, mode) {
+        const params = new URLSearchParams();
+        if (version)
+            params.set("version", version);
+        if (mode)
+            params.set("mode", mode);
+        const query = params.toString() ? `?${params.toString()}` : "";
         return this.client.request(`/map/image${query}`);
     }
     /**

package/dist/resources/news.d.ts

@@ -5,18 +5,22 @@ export declare class NewsResource {
     constructor(client: FortniteAPI);
     /**
      * Get Battle Royale news
+     * @param lang - Language code (default: en)
      */
-    getBRNews(): Promise<NewsResponse<BRNews>>;
+    getBRNews(lang?: string): Promise<NewsResponse<BRNews>>;
     /**
      * Get Save The World news
+     * @param lang - Language code (default: en)
      */
-    getSTWNews(): Promise<NewsResponse<STWNews>>;
+    getSTWNews(lang?: string): Promise<NewsResponse<STWNews>>;
     /**
      * Get Creative news
+     * @param lang - Language code (default: en)
      */
-    getCreativeNews(): Promise<NewsResponse<CreativeNews>>;
+    getCreativeNews(lang?: string): Promise<NewsResponse<CreativeNews>>;
     /**
      * Get all news (BR, STW, Creative)
+     * @param lang - Language code (default: en)
      */
-    getAllNews(): Promise<NewsResponse<AllNews>>;
+    getAllNews(lang?: string): Promise<NewsResponse<AllNews>>;
 }

package/dist/resources/news.js

@@ -7,27 +7,35 @@ class NewsResource {
     }
     /**
      * Get Battle Royale news
+     * @param lang - Language code (default: en)
      */
-    async getBRNews() {
-        return this.client.request("/news/br");
+    async getBRNews(lang) {
+        const query = lang ? `?lang=${encodeURIComponent(lang)}` : "";
+        return this.client.request(`/news/br${query}`);
     }
     /**
      * Get Save The World news
+     * @param lang - Language code (default: en)
      */
-    async getSTWNews() {
-        return this.client.request("/news/stw");
+    async getSTWNews(lang) {
+        const query = lang ? `?lang=${encodeURIComponent(lang)}` : "";
+        return this.client.request(`/news/stw${query}`);
     }
     /**
      * Get Creative news
+     * @param lang - Language code (default: en)
      */
-    async getCreativeNews() {
-        return this.client.request("/news/creative");
+    async getCreativeNews(lang) {
+        const query = lang ? `?lang=${encodeURIComponent(lang)}` : "";
+        return this.client.request(`/news/creative${query}`);
     }
     /**
      * Get all news (BR, STW, Creative)
+     * @param lang - Language code (default: en)
      */
-    async getAllNews() {
-        return this.client.request("/news");
+    async getAllNews(lang) {
+        const query = lang ? `?lang=${encodeURIComponent(lang)}` : "";
+        return this.client.request(`/news${query}`);
     }
 }
 exports.NewsResource = NewsResource;

package/dist/resources/oauth.d.ts

@@ -1,5 +1,5 @@
 import { FortniteAPI } from "../client";
-import { OAuthCompleteResponse, OAuthDeviceRefreshResponse, OAuthExchangeCodeResponse, OAuthFlowResponse, OAuthRefreshResponse } from "../types";
+import { OAuthCompleteResponse, OAuthDeviceRefreshResponse, OAuthExchangeCodeResponse, OAuthFlowResponse, OAuthRefreshResponse, OAuthAuthorizeUrlResponse } from "../types";
 export declare class OauthResource {
     private client;
     constructor(client: FortniteAPI);
@@ -37,4 +37,29 @@ export declare class OauthResource {
         deviceId: string;
         secret: string;
     }): Promise<OAuthDeviceRefreshResponse>;
+    /**
+     * Get Epic Games authorization URL - GET /oauth/authorize-url
+     * Returns the URL to redirect the user to for standard Epic login (no device confirmation page).
+     * After login, Epic redirects to your redirect_uri with ?code=...
+     * Then call linkAccount() with that code to get the Fortnite access token and device auth.
+     * @param redirectUri - Optional redirect URI registered with Epic
+     */
+    getAuthorizeUrl(redirectUri?: string): Promise<OAuthAuthorizeUrlResponse>;
+    /**
+     * Link Epic account - POST /oauth/link
+     * Exchanges an Epic authorization code (from GET /oauth/authorize-url flow) for a
+     * Fortnite access token and device auth credentials.
+     * Store the returned deviceAuth (accountId + deviceId + secret) and use refreshDevice()
+     * to silently re-authenticate in the future — no browser required.
+     * @param params.code - Authorization code returned by Epic in the redirect URI
+     * @param params.redirectUri - Must match the redirect URI used in getAuthorizeUrl()
+     * @param params.clientId - Optional custom Epic OAuth client ID
+     * @param params.clientSecret - Optional custom Epic OAuth client secret
+     */
+    linkAccount(params: {
+        code: string;
+        redirectUri?: string;
+        clientId?: string;
+        clientSecret?: string;
+    }): Promise<OAuthCompleteResponse>;
 }

package/dist/resources/oauth.js

@@ -52,5 +52,33 @@ class OauthResource {
             body: JSON.stringify(params),
         });
     }
+    /**
+     * Get Epic Games authorization URL - GET /oauth/authorize-url
+     * Returns the URL to redirect the user to for standard Epic login (no device confirmation page).
+     * After login, Epic redirects to your redirect_uri with ?code=...
+     * Then call linkAccount() with that code to get the Fortnite access token and device auth.
+     * @param redirectUri - Optional redirect URI registered with Epic
+     */
+    async getAuthorizeUrl(redirectUri) {
+        const query = redirectUri ? `?redirectUri=${encodeURIComponent(redirectUri)}` : "";
+        return this.client.request(`/oauth/authorize-url${query}`, {}, "v1");
+    }
+    /**
+     * Link Epic account - POST /oauth/link
+     * Exchanges an Epic authorization code (from GET /oauth/authorize-url flow) for a
+     * Fortnite access token and device auth credentials.
+     * Store the returned deviceAuth (accountId + deviceId + secret) and use refreshDevice()
+     * to silently re-authenticate in the future — no browser required.
+     * @param params.code - Authorization code returned by Epic in the redirect URI
+     * @param params.redirectUri - Must match the redirect URI used in getAuthorizeUrl()
+     * @param params.clientId - Optional custom Epic OAuth client ID
+     * @param params.clientSecret - Optional custom Epic OAuth client secret
+     */
+    async linkAccount(params) {
+        return this.client.request("/oauth/link", {
+            method: "POST",
+            body: JSON.stringify(params),
+        }, "v1");
+    }
 }
 exports.OauthResource = OauthResource;