@yaelouuu/fortnite-api 7.1.0 → 7.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -1,44 +1,14 @@
|
|
|
1
1
|
import { FortniteAPI } from "../client";
|
|
2
|
-
import {
|
|
2
|
+
import { EventLeaderboard, PlayerTokensResponse } from "../types";
|
|
3
3
|
/**
|
|
4
4
|
* Events Resource
|
|
5
|
-
* Handles tournament and competitive events data
|
|
5
|
+
* Handles tournament and competitive events leaderboard data
|
|
6
6
|
*/
|
|
7
7
|
export declare class EventsResource {
|
|
8
8
|
private client;
|
|
9
9
|
constructor(client: FortniteAPI);
|
|
10
10
|
/**
|
|
11
|
-
* Get event
|
|
12
|
-
* @param eventId - Event ID
|
|
13
|
-
* @param fortniteToken - Optional user Fortnite token
|
|
14
|
-
* @returns Event windows data
|
|
15
|
-
*/
|
|
16
|
-
getEventWindows(eventId: string, fortniteToken?: string): Promise<EventWindows>;
|
|
17
|
-
/**
|
|
18
|
-
* Get player event history
|
|
19
|
-
* @param accountId - Account ID
|
|
20
|
-
* @param fortniteToken - Optional user Fortnite token
|
|
21
|
-
* @returns Array of events player participated in
|
|
22
|
-
*/
|
|
23
|
-
getPlayerHistory(accountId: string, fortniteToken?: string): Promise<PlayerEventHistory[]>;
|
|
24
|
-
/**
|
|
25
|
-
* Get tournament details
|
|
26
|
-
* @param eventId - Event ID
|
|
27
|
-
* @param eventWindowId - Event window ID
|
|
28
|
-
* @param fortniteToken - Optional user Fortnite token
|
|
29
|
-
* @returns Tournament details
|
|
30
|
-
*/
|
|
31
|
-
getTournamentDetails(eventId: string, eventWindowId: string, fortniteToken?: string): Promise<TournamentDetails>;
|
|
32
|
-
/**
|
|
33
|
-
* Get event scoring rules
|
|
34
|
-
* @param eventId - Event ID
|
|
35
|
-
* @param eventWindowId - Event window ID
|
|
36
|
-
* @param fortniteToken - Optional user Fortnite token
|
|
37
|
-
* @returns Scoring rules
|
|
38
|
-
*/
|
|
39
|
-
getScoringRules(eventId: string, eventWindowId: string, fortniteToken?: string): Promise<ScoringRules>;
|
|
40
|
-
/**
|
|
41
|
-
* Get event leaderboard
|
|
11
|
+
* Get the paginated leaderboard for a specific event window
|
|
42
12
|
* @param eventId - Event ID
|
|
43
13
|
* @param eventWindowId - Event window ID
|
|
44
14
|
* @param options - Query options
|
|
@@ -47,16 +17,8 @@ export declare class EventsResource {
|
|
|
47
17
|
*/
|
|
48
18
|
getLeaderboard(eventId: string, eventWindowId: string, options?: {
|
|
49
19
|
page?: number;
|
|
20
|
+
leaderboardDef?: string;
|
|
50
21
|
}, fortniteToken?: string): Promise<EventLeaderboard>;
|
|
51
|
-
/**
|
|
52
|
-
* Get player event data
|
|
53
|
-
* @param eventId - Event ID
|
|
54
|
-
* @param eventWindowId - Event window ID
|
|
55
|
-
* @param accountId - Account ID
|
|
56
|
-
* @param fortniteToken - Optional user Fortnite token
|
|
57
|
-
* @returns Player's event performance data
|
|
58
|
-
*/
|
|
59
|
-
getPlayerEventData(eventId: string, eventWindowId: string, accountId: string, fortniteToken?: string): Promise<PlayerEventData>;
|
|
60
22
|
/**
|
|
61
23
|
* Find a player's rank and surrounding entries in an event window leaderboard.
|
|
62
24
|
* Works for any placement including beyond top 10k. No user token required.
|
|
@@ -73,12 +35,4 @@ export declare class EventsResource {
|
|
|
73
35
|
* @param accountIds - One or more Epic account IDs
|
|
74
36
|
*/
|
|
75
37
|
getPlayerTokens(accountIds: string | string[]): Promise<PlayerTokensResponse>;
|
|
76
|
-
/**
|
|
77
|
-
* Get event rewards/prizes
|
|
78
|
-
* @param eventId - Event ID
|
|
79
|
-
* @param eventWindowId - Event window ID
|
|
80
|
-
* @param fortniteToken - Optional user Fortnite token
|
|
81
|
-
* @returns Event rewards structure
|
|
82
|
-
*/
|
|
83
|
-
getEventRewards(eventId: string, eventWindowId: string, fortniteToken?: string): Promise<EventRewards>;
|
|
84
38
|
}
|
package/dist/resources/events.js
CHANGED
|
@@ -3,68 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
3
3
|
exports.EventsResource = void 0;
|
|
4
4
|
/**
|
|
5
5
|
* Events Resource
|
|
6
|
-
* Handles tournament and competitive events data
|
|
6
|
+
* Handles tournament and competitive events leaderboard data
|
|
7
7
|
*/
|
|
8
8
|
class EventsResource {
|
|
9
9
|
constructor(client) {
|
|
10
10
|
this.client = client;
|
|
11
11
|
}
|
|
12
12
|
/**
|
|
13
|
-
* Get event
|
|
14
|
-
* @param eventId - Event ID
|
|
15
|
-
* @param fortniteToken - Optional user Fortnite token
|
|
16
|
-
* @returns Event windows data
|
|
17
|
-
*/
|
|
18
|
-
async getEventWindows(eventId, fortniteToken) {
|
|
19
|
-
const headers = {};
|
|
20
|
-
if (fortniteToken) {
|
|
21
|
-
headers["x-fortnite-token"] = fortniteToken;
|
|
22
|
-
}
|
|
23
|
-
return this.client.request(`/events/${eventId}/windows`, { headers }, "v2");
|
|
24
|
-
}
|
|
25
|
-
/**
|
|
26
|
-
* Get player event history
|
|
27
|
-
* @param accountId - Account ID
|
|
28
|
-
* @param fortniteToken - Optional user Fortnite token
|
|
29
|
-
* @returns Array of events player participated in
|
|
30
|
-
*/
|
|
31
|
-
async getPlayerHistory(accountId, fortniteToken) {
|
|
32
|
-
const headers = {};
|
|
33
|
-
if (fortniteToken) {
|
|
34
|
-
headers["x-fortnite-token"] = fortniteToken;
|
|
35
|
-
}
|
|
36
|
-
return this.client.request(`/events/history/${accountId}`, { headers }, "v2");
|
|
37
|
-
}
|
|
38
|
-
/**
|
|
39
|
-
* Get tournament details
|
|
40
|
-
* @param eventId - Event ID
|
|
41
|
-
* @param eventWindowId - Event window ID
|
|
42
|
-
* @param fortniteToken - Optional user Fortnite token
|
|
43
|
-
* @returns Tournament details
|
|
44
|
-
*/
|
|
45
|
-
async getTournamentDetails(eventId, eventWindowId, fortniteToken) {
|
|
46
|
-
const headers = {};
|
|
47
|
-
if (fortniteToken) {
|
|
48
|
-
headers["x-fortnite-token"] = fortniteToken;
|
|
49
|
-
}
|
|
50
|
-
return this.client.request(`/events/${eventId}/windows/${eventWindowId}`, { headers }, "v2");
|
|
51
|
-
}
|
|
52
|
-
/**
|
|
53
|
-
* Get event scoring rules
|
|
54
|
-
* @param eventId - Event ID
|
|
55
|
-
* @param eventWindowId - Event window ID
|
|
56
|
-
* @param fortniteToken - Optional user Fortnite token
|
|
57
|
-
* @returns Scoring rules
|
|
58
|
-
*/
|
|
59
|
-
async getScoringRules(eventId, eventWindowId, fortniteToken) {
|
|
60
|
-
const headers = {};
|
|
61
|
-
if (fortniteToken) {
|
|
62
|
-
headers["x-fortnite-token"] = fortniteToken;
|
|
63
|
-
}
|
|
64
|
-
return this.client.request(`/events/${eventId}/windows/${eventWindowId}/scoring`, { headers }, "v2");
|
|
65
|
-
}
|
|
66
|
-
/**
|
|
67
|
-
* Get event leaderboard
|
|
13
|
+
* Get the paginated leaderboard for a specific event window
|
|
68
14
|
* @param eventId - Event ID
|
|
69
15
|
* @param eventWindowId - Event window ID
|
|
70
16
|
* @param options - Query options
|
|
@@ -76,23 +22,13 @@ class EventsResource {
|
|
|
76
22
|
if (fortniteToken) {
|
|
77
23
|
headers["x-fortnite-token"] = fortniteToken;
|
|
78
24
|
}
|
|
79
|
-
const
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
* @param accountId - Account ID
|
|
87
|
-
* @param fortniteToken - Optional user Fortnite token
|
|
88
|
-
* @returns Player's event performance data
|
|
89
|
-
*/
|
|
90
|
-
async getPlayerEventData(eventId, eventWindowId, accountId, fortniteToken) {
|
|
91
|
-
const headers = {};
|
|
92
|
-
if (fortniteToken) {
|
|
93
|
-
headers["x-fortnite-token"] = fortniteToken;
|
|
94
|
-
}
|
|
95
|
-
return this.client.request(`/events/${eventId}/windows/${eventWindowId}/players/${accountId}`, { headers }, "v2");
|
|
25
|
+
const params = new URLSearchParams();
|
|
26
|
+
if (options?.page != null)
|
|
27
|
+
params.append("page", String(options.page));
|
|
28
|
+
if (options?.leaderboardDef)
|
|
29
|
+
params.append("leaderboardDef", options.leaderboardDef);
|
|
30
|
+
const qs = params.toString();
|
|
31
|
+
return this.client.request(`/events/${eventId}/windows/${eventWindowId}/leaderboard${qs ? `?${qs}` : ""}`, { headers }, "v2");
|
|
96
32
|
}
|
|
97
33
|
/**
|
|
98
34
|
* Find a player's rank and surrounding entries in an event window leaderboard.
|
|
@@ -116,19 +52,5 @@ class EventsResource {
|
|
|
116
52
|
const qs = ids.map(encodeURIComponent).join("%2C");
|
|
117
53
|
return this.client.request(`/events/tokens?teamAccountIds=${qs}`, {}, "v1");
|
|
118
54
|
}
|
|
119
|
-
/**
|
|
120
|
-
* Get event rewards/prizes
|
|
121
|
-
* @param eventId - Event ID
|
|
122
|
-
* @param eventWindowId - Event window ID
|
|
123
|
-
* @param fortniteToken - Optional user Fortnite token
|
|
124
|
-
* @returns Event rewards structure
|
|
125
|
-
*/
|
|
126
|
-
async getEventRewards(eventId, eventWindowId, fortniteToken) {
|
|
127
|
-
const headers = {};
|
|
128
|
-
if (fortniteToken) {
|
|
129
|
-
headers["x-fortnite-token"] = fortniteToken;
|
|
130
|
-
}
|
|
131
|
-
return this.client.request(`/events/${eventId}/windows/${eventWindowId}/rewards`, { headers }, "v2");
|
|
132
|
-
}
|
|
133
55
|
}
|
|
134
56
|
exports.EventsResource = EventsResource;
|
|
@@ -18,9 +18,14 @@ export declare class ProfilesResource {
|
|
|
18
18
|
getLevel(accountId: string, fortniteToken: string): Promise<ProfileLevel>;
|
|
19
19
|
/**
|
|
20
20
|
* Get enriched ranked progress — human-readable rank names, game mode labels, season dates.
|
|
21
|
-
*
|
|
21
|
+
* Accepts either a display name or an account ID. Account ID is preferred: it is faster
|
|
22
|
+
* (skips the name→ID lookup) and is not affected by display name changes.
|
|
23
|
+
* @param displayName - Epic Games display name (ignored if accountId is provided)
|
|
24
|
+
* @param options - Optional: pass `accountId` to bypass the name lookup
|
|
22
25
|
*/
|
|
23
|
-
getRanked(displayName: string
|
|
26
|
+
getRanked(displayName: string, options?: {
|
|
27
|
+
accountId?: string;
|
|
28
|
+
}): Promise<RankedProgress[]>;
|
|
24
29
|
/**
|
|
25
30
|
* Get all available ranked game mode tracks — modes, division counts, and season dates.
|
|
26
31
|
* @param options - Optional filters
|
|
@@ -24,10 +24,20 @@ class ProfilesResource {
|
|
|
24
24
|
}
|
|
25
25
|
/**
|
|
26
26
|
* Get enriched ranked progress — human-readable rank names, game mode labels, season dates.
|
|
27
|
-
*
|
|
27
|
+
* Accepts either a display name or an account ID. Account ID is preferred: it is faster
|
|
28
|
+
* (skips the name→ID lookup) and is not affected by display name changes.
|
|
29
|
+
* @param displayName - Epic Games display name (ignored if accountId is provided)
|
|
30
|
+
* @param options - Optional: pass `accountId` to bypass the name lookup
|
|
28
31
|
*/
|
|
29
|
-
async getRanked(displayName) {
|
|
30
|
-
|
|
32
|
+
async getRanked(displayName, options) {
|
|
33
|
+
const params = new URLSearchParams();
|
|
34
|
+
if (options?.accountId) {
|
|
35
|
+
params.append("accountId", options.accountId);
|
|
36
|
+
}
|
|
37
|
+
else {
|
|
38
|
+
params.append("displayName", displayName);
|
|
39
|
+
}
|
|
40
|
+
return this.client.request(`/profile/ranked?${params.toString()}`);
|
|
31
41
|
}
|
|
32
42
|
/**
|
|
33
43
|
* Get all available ranked game mode tracks — modes, division counts, and season dates.
|