@yaelouuu/fortnite-api 3.1.0 → 4.1.0

package/dist/client.d.ts

@@ -6,6 +6,8 @@ import { BundlesResource } from "./resources/bundles";
 import { OauthResource } from "./resources/oauth";
 import { ParsingResource } from "./resources/parsing";
 import { WeaponsResource } from "./resources/weapons";
+import { BattlePassResource } from "./resources/battlepass";
+import { QuestsResource } from "./resources/quests";
 export interface ClientOptions {
     apiKey: string;
     baseUrl?: string;
@@ -21,13 +23,15 @@ export declare class FortniteAPI {
     oauth: OauthResource;
     parsing: ParsingResource;
     weapons: WeaponsResource;
+    battlepass: BattlePassResource;
+    quests: QuestsResource;
     constructor(options: ClientOptions);
     /**
      * Internal method to make HTTP requests
      */
-    request<T>(endpoint: string, options?: RequestInit): Promise<T>;
+    request<T>(endpoint: string, options?: RequestInit, version?: "v1" | "v2" | "v3"): Promise<T>;
     /**
      * Internal method for multipart/form-data requests (file uploads)
      */
-    requestMultipart<T>(endpoint: string, formData: FormData): Promise<T>;
+    requestMultipart<T>(endpoint: string, formData: FormData, version?: "v1" | "v2" | "v3"): Promise<T>;
 }

package/dist/client.js

@@ -10,10 +10,12 @@ const bundles_1 = require("./resources/bundles");
 const oauth_1 = require("./resources/oauth");
 const parsing_1 = require("./resources/parsing");
 const weapons_1 = require("./resources/weapons");
+const battlepass_1 = require("./resources/battlepass");
+const quests_1 = require("./resources/quests");
 class FortniteAPI {
     constructor(options) {
         this.apiKey = options.apiKey;
-        this.baseUrl = options.baseUrl || "https://prod.api-fortnite.com/api/v1";
+        this.baseUrl = options.baseUrl || "https://prod.api-fortnite.com/api";
         // this.baseUrl = options.baseUrl || "http://localhost:4321/api/v1";
         // Initialize resources
         this.shop = new shop_1.ShopResource(this);
@@ -24,12 +26,14 @@ class FortniteAPI {
         this.oauth = new oauth_1.OauthResource(this);
         this.parsing = new parsing_1.ParsingResource(this);
         this.weapons = new weapons_1.WeaponsResource(this);
+        this.battlepass = new battlepass_1.BattlePassResource(this);
+        this.quests = new quests_1.QuestsResource(this);
     }
     /**
      * Internal method to make HTTP requests
      */
-    async request(endpoint, options = {}) {
-        const url = `${this.baseUrl}${endpoint}`;
+    async request(endpoint, options = {}, version = "v1") {
+        const url = `${this.baseUrl}/${version}${endpoint}`;
         const response = await fetch(url, {
             ...options,
             headers: {
@@ -54,8 +58,8 @@ class FortniteAPI {
     /**
      * Internal method for multipart/form-data requests (file uploads)
      */
-    async requestMultipart(endpoint, formData) {
-        const url = `${this.baseUrl}${endpoint}`;
+    async requestMultipart(endpoint, formData, version = "v1") {
+        const url = `${this.baseUrl}/${version}${endpoint}`;
         const response = await fetch(url, {
             method: "POST",
             headers: {

package/dist/resources/battlepass.d.ts

@@ -0,0 +1,10 @@
+import { FortniteAPI } from "../client";
+import { BattlePass } from "../types";
+export declare class BattlePassResource {
+    private client;
+    constructor(client: FortniteAPI);
+    /**
+     * Get current battle pass items
+     */
+    getBattlePass(): Promise<BattlePass>;
+}

package/dist/resources/battlepass.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BattlePassResource = void 0;
+class BattlePassResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get current battle pass items
+     */
+    async getBattlePass() {
+        return this.client.request("/battlepass");
+    }
+}
+exports.BattlePassResource = BattlePassResource;

package/dist/resources/quests.d.ts

@@ -0,0 +1,14 @@
+import { FortniteAPI } from "../client";
+import { QuestsResponse } from "../types";
+export declare class QuestsResource {
+    private client;
+    constructor(client: FortniteAPI);
+    /**
+     * Get account quests and level information
+     * Requires user's own Fortnite token
+     * @param accountId - Epic Games Account ID
+     * @param fortniteToken - User's Fortnite access token (from OAuth flow)
+     * @returns Quest progress, XP, playtime, and account level data
+     */
+    getQuests(accountId: string, fortniteToken: string): Promise<QuestsResponse>;
+}

package/dist/resources/quests.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuestsResource = void 0;
+class QuestsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get account quests and level information
+     * Requires user's own Fortnite token
+     * @param accountId - Epic Games Account ID
+     * @param fortniteToken - User's Fortnite access token (from OAuth flow)
+     * @returns Quest progress, XP, playtime, and account level data
+     */
+    async getQuests(accountId, fortniteToken) {
+        return this.client.request(`/quests/${accountId}`, {
+            headers: {
+                "x-fortnite-token": fortniteToken,
+            },
+        }, "v3");
+    }
+}
+exports.QuestsResource = QuestsResource;

package/dist/resources/tournaments.d.ts

@@ -66,4 +66,17 @@ export declare class TournamentsResource {
         days?: number;
         requiredTournaments?: number;
     }): Promise<TournamentEligibilityResponse>;
+    /**
+     * Get tournament leaderboard using V2 endpoint (POST with teams body)
+     * @param params.eventId - Event ID
+     * @param params.eventWindowId - Event window ID
+     * @param params.leaderboardDef - Optional leaderboard definition (required for Ranked Cups)
+     * @param teams - Array of team member account ID arrays (e.g., [["accountId1"], ["accountId2"]])
+     * @param fortniteToken - Optional user's Fortnite token for personalized view
+     */
+    getLeaderboardV2(params: {
+        eventId: string;
+        eventWindowId: string;
+        leaderboardDef?: string;
+    }, teams: string[][], fortniteToken?: string): Promise<Leaderboard>;
 }

package/dist/resources/tournaments.js

@@ -112,5 +112,32 @@ class TournamentsResource {
             },
         });
     }
+    /**
+     * Get tournament leaderboard using V2 endpoint (POST with teams body)
+     * @param params.eventId - Event ID
+     * @param params.eventWindowId - Event window ID
+     * @param params.leaderboardDef - Optional leaderboard definition (required for Ranked Cups)
+     * @param teams - Array of team member account ID arrays (e.g., [["accountId1"], ["accountId2"]])
+     * @param fortniteToken - Optional user's Fortnite token for personalized view
+     */
+    async getLeaderboardV2(params, teams, fortniteToken) {
+        const query = new URLSearchParams({
+            eventId: params.eventId,
+            eventWindowId: params.eventWindowId,
+        });
+        if (params.leaderboardDef) {
+            query.append("leaderboardDef", params.leaderboardDef);
+        }
+        const options = {
+            method: "POST",
+            body: JSON.stringify({ teams }),
+        };
+        if (fortniteToken) {
+            options.headers = {
+                "x-fortnite-token": fortniteToken,
+            };
+        }
+        return this.client.request(`/events/leaderboard?${query.toString()}`, options, "v2");
+    }
 }
 exports.TournamentsResource = TournamentsResource;

package/dist/resources/weapons.js

@@ -9,7 +9,7 @@ class WeaponsResource {
      * Get weapons and infos
      */
     async getWeapons() {
-        return this.client.request("/weapons");
+        return this.client.request("/weapons", {}, "v2");
     }
 }
 exports.WeaponsResource = WeaponsResource;

package/dist/types/index.d.ts

@@ -217,3 +217,78 @@ export interface WeaponsStats {
     overheatedCooldownDelay: number;
     maxDamagePerCartridge: number;
 }
+export interface BattlePass {
+    battlePassContent: BattlePassContent;
+    battlePassOffers: Array<BattlePassOffers>;
+}
+export interface MessagesBP {
+    layout: string;
+    image: string;
+    hidden?: boolean;
+    _type: string;
+    title: string;
+    body: string;
+    spotlight: boolean;
+}
+export interface BattlePassContent {
+    news: {
+        _type: string;
+        messages: Array<MessagesBP>;
+    };
+    _title: string;
+    _noIndex: boolean;
+    _activeDate: string;
+    lastModified: string;
+    _locale: string;
+    _templateName: string;
+    _suggestedPrefetch: Array<any>;
+}
+export interface PricesBP {
+    currencyType: string;
+    currencySubType: string;
+    regularPrice: number;
+    dynamicRegularPrice: number;
+    finalPrice: number;
+    saleExpiration: string;
+    basePrice: number;
+}
+export interface RequirementsBP {
+    requirementType: string;
+    requiredId: string;
+    minQuantity: number;
+}
+export interface MetaInfoBP {
+    key: string;
+    value: string;
+}
+export interface BattlePassOffers {
+    offerId: string;
+    devName: string;
+    offerType: string;
+    prices: Array<PricesBP>;
+    categories: Array<any>;
+    dailyLimit: number;
+    weeklyLimit: number;
+    monthlyLimit: number;
+    refundable: boolean;
+    appStoreId: Array<string>;
+    requirements: Array<RequirementsBP>;
+    metaInfo: Array<MetaInfoBP>;
+    catalogGroup: string;
+    catalogGroupPriority: number;
+    sortPriority: number;
+    title: string;
+    shortDescription: string;
+    description: string;
+    displayAssetPath: string;
+    itemGrants: Array<any>;
+    sectionId: string | null;
+    sectionDisplayName: string | null;
+    sectionPriority: number | null;
+    sectionBackground: null | null;
+    offerVisual: string | null;
+    tileSize: string;
+}
+export interface QuestsResponse {
+    [key: string]: any;
+}

package/package.json

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