@yaelouuu/fortnite-api 4.3.0 → 4.5.0

package/README.md

@@ -345,6 +345,127 @@ const psnAuth = await client.account.getExternalAuth('accountId123', 'psn');
 
 ---
 
+### News - **NEW**
+
+Get Fortnite news and announcements for all game modes.
+
+```typescript
+// Get Battle Royale news
+const brNews = await client.news.getBRNews();
+// Returns: MOTDs, platform messages, images, and videos
+
+// Get Save The World news
+const stwNews = await client.news.getSTWNews();
+
+// Get Creative news
+const creativeNews = await client.news.getCreativeNews();
+
+// Get all news at once
+const allNews = await client.news.getAllNews();
+// Returns: { br, stw, creative, lastModified }
+```
+
+---
+
+### Cosmetics - **NEW**
+
+Browse and search the complete Fortnite cosmetics catalog.
+
+#### Get All Cosmetics
+```typescript
+const cosmetics = await client.cosmetics.getAll({
+  page: 1,
+  pageSize: 50,
+  type: 'outfit',  // outfit, backpack, pickaxe, glider, emote, wrap, music, etc.
+  rarity: 'legendary',  // common, uncommon, rare, epic, legendary, mythic
+  set: 'Dark Series'
+});
+// Returns: Paginated list with item details
+```
+
+#### Get Cosmetic by ID
+```typescript
+const item = await client.cosmetics.getById('CID_123_Athena');
+// Returns: Detailed cosmetic information
+```
+
+#### Search Cosmetics
+```typescript
+const results = await client.cosmetics.search('galaxy', {
+  page: 1,
+  pageSize: 20,
+  type: 'outfit'
+});
+// Search by name or description
+```
+
+#### Get New Cosmetics
+```typescript
+const newItems = await client.cosmetics.getNew({
+  page: 1,
+  pageSize: 50
+});
+// Returns: Recently added cosmetics
+```
+
+---
+
+### Crew - **NEW**
+
+Fortnite Crew subscription pack information.
+
+```typescript
+// Get current month's Crew Pack
+const current = await client.crew.getCurrent();
+// Returns: Current crew pack with cosmetics and details
+
+// Get Crew Pack history
+const history = await client.crew.getHistory();
+// Returns: All previous crew packs
+```
+
+---
+
+### Map - **NEW**
+
+Current and historical Fortnite map data.
+
+```typescript
+// Get current map with POIs
+const map = await client.map.getCurrent();
+// Returns: Map data with points of interest
+
+// Get map image URL
+const mapImage = await client.map.getImage();
+// Returns: Current map image URL
+
+// Get historical map data
+const history = await client.map.getHistory();
+// Returns: Previous map versions
+```
+
+---
+
+### Playlists - **NEW**
+
+Fortnite playlists and game modes.
+
+```typescript
+// Get all playlists
+const allPlaylists = await client.playlists.getAll();
+// Returns: All game modes and playlists
+
+// Get active playlists only
+const active = await client.playlists.getActive();
+// Returns: Currently available playlists
+
+// Get specific playlist
+const playlist = await client.playlists.getById('Playlist_DefaultSolo');
+// Returns: Detailed playlist information
+```
+
+---
+
 ### FN (Fortnite Game) - **NEW**
 
 Fortnite-specific game data including inventory, features, and settings.
@@ -497,6 +618,32 @@ MIT
 
 ## 🆕 Changelog
 
+### v4.3.0 (2026-01-08)
+- ✨ **NEW** `NewsResource` with 4 methods:
+  - Battle Royale news
+  - Save The World news
+  - Creative news
+  - All news in one call
+- ✨ **NEW** `CosmeticsResource` with 4 methods:
+  - Browse all cosmetics with filters (type, rarity, set)
+  - Search cosmetics by name
+  - Get cosmetic by ID
+  - Get newly added cosmetics
+- ✨ **NEW** `CrewResource` with 2 methods:
+  - Current Crew Pack
+  - Crew Pack history
+- ✨ **NEW** `MapResource` with 3 methods:
+  - Current map with POIs
+  - Map image URL
+  - Historical map data
+- ✨ **NEW** `PlaylistsResource` with 3 methods:
+  - All playlists/game modes
+  - Active playlists only
+  - Specific playlist by ID
+- 📝 Comprehensive TypeScript types for all new endpoints
+- 🎯 Complete SDK coverage for all API endpoints
+- ✅ 100% backward compatible
+
 ### v4.2.0 (2026-01-06)
 - ✨ **NEW** `AccountResource` with 8 methods:
   - Account lookups by ID, display name, and external platforms

package/dist/client.d.ts

@@ -13,6 +13,11 @@ import { FNResource } from "./resources/fn";
 import { FriendsResource } from "./resources/friends";
 import { StatsResource } from "./resources/stats";
 import { EventsResource } from "./resources/events";
+import { NewsResource } from "./resources/news";
+import { CosmeticsResource } from "./resources/cosmetics";
+import { CrewResource } from "./resources/crew";
+import { MapResource } from "./resources/map";
+import { PlaylistsResource } from "./resources/playlists";
 export interface ClientOptions {
     apiKey: string;
     baseUrl?: string;
@@ -35,6 +40,11 @@ export declare class FortniteAPI {
     friends: FriendsResource;
     stats: StatsResource;
     events: EventsResource;
+    news: NewsResource;
+    cosmetics: CosmeticsResource;
+    crew: CrewResource;
+    map: MapResource;
+    playlists: PlaylistsResource;
     constructor(options: ClientOptions);
     /**
      * Internal method to make HTTP requests

package/dist/client.js

@@ -17,6 +17,11 @@ const fn_1 = require("./resources/fn");
 const friends_1 = require("./resources/friends");
 const stats_1 = require("./resources/stats");
 const events_1 = require("./resources/events");
+const news_1 = require("./resources/news");
+const cosmetics_1 = require("./resources/cosmetics");
+const crew_1 = require("./resources/crew");
+const map_1 = require("./resources/map");
+const playlists_1 = require("./resources/playlists");
 class FortniteAPI {
     constructor(options) {
         this.apiKey = options.apiKey;
@@ -38,6 +43,11 @@ class FortniteAPI {
         this.friends = new friends_1.FriendsResource(this);
         this.stats = new stats_1.StatsResource(this);
         this.events = new events_1.EventsResource(this);
+        this.news = new news_1.NewsResource(this);
+        this.cosmetics = new cosmetics_1.CosmeticsResource(this);
+        this.crew = new crew_1.CrewResource(this);
+        this.map = new map_1.MapResource(this);
+        this.playlists = new playlists_1.PlaylistsResource(this);
     }
     /**
      * Internal method to make HTTP requests

package/dist/resources/cosmetics.d.ts

@@ -0,0 +1,25 @@
+import { FortniteAPI } from "../client";
+import { CosmeticsResponse, CosmeticItem, CosmeticsPaginatedResponse, CosmeticsSearchParams } from "../types";
+export declare class CosmeticsResource {
+    private client;
+    constructor(client: FortniteAPI);
+    /**
+     * Get all cosmetics with pagination and filters
+     */
+    getAll(params?: CosmeticsSearchParams): Promise<CosmeticsPaginatedResponse>;
+    /**
+     * Get a specific cosmetic by ID
+     */
+    getById(id: string): Promise<CosmeticsResponse<CosmeticItem>>;
+    /**
+     * Search cosmetics by name or description
+     */
+    search(query: string, params?: Omit<CosmeticsSearchParams, 'search'>): Promise<CosmeticsPaginatedResponse>;
+    /**
+     * Get recently added cosmetics
+     */
+    getNew(params?: {
+        page?: number;
+        pageSize?: number;
+    }): Promise<CosmeticsPaginatedResponse>;
+}

package/dist/resources/cosmetics.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CosmeticsResource = void 0;
+class CosmeticsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get all cosmetics with pagination and filters
+     */
+    async getAll(params) {
+        const queryParams = new URLSearchParams();
+        if (params?.page)
+            queryParams.set("page", params.page.toString());
+        if (params?.pageSize)
+            queryParams.set("pageSize", params.pageSize.toString());
+        if (params?.type)
+            queryParams.set("type", params.type);
+        if (params?.rarity)
+            queryParams.set("rarity", params.rarity);
+        if (params?.set)
+            queryParams.set("set", params.set);
+        if (params?.search)
+            queryParams.set("search", params.search);
+        const query = queryParams.toString();
+        const endpoint = query ? `/cosmetics/all?${query}` : "/cosmetics/all";
+        return this.client.request(endpoint);
+    }
+    /**
+     * Get a specific cosmetic by ID
+     */
+    async getById(id) {
+        return this.client.request(`/cosmetics/${id}`);
+    }
+    /**
+     * Search cosmetics by name or description
+     */
+    async search(query, params) {
+        const queryParams = new URLSearchParams();
+        queryParams.set("q", query);
+        if (params?.page)
+            queryParams.set("page", params.page.toString());
+        if (params?.pageSize)
+            queryParams.set("pageSize", params.pageSize.toString());
+        if (params?.type)
+            queryParams.set("type", params.type);
+        if (params?.rarity)
+            queryParams.set("rarity", params.rarity);
+        if (params?.set)
+            queryParams.set("set", params.set);
+        return this.client.request(`/cosmetics/search?${queryParams.toString()}`);
+    }
+    /**
+     * Get recently added cosmetics
+     */
+    async getNew(params) {
+        const queryParams = new URLSearchParams();
+        if (params?.page)
+            queryParams.set("page", params.page.toString());
+        if (params?.pageSize)
+            queryParams.set("pageSize", params.pageSize.toString());
+        const query = queryParams.toString();
+        const endpoint = query ? `/cosmetics/new?${query}` : "/cosmetics/new";
+        return this.client.request(endpoint);
+    }
+}
+exports.CosmeticsResource = CosmeticsResource;

package/dist/resources/crew.d.ts

@@ -0,0 +1,14 @@
+import { FortniteAPI } from "../client";
+import { CrewPackResponse, CrewHistoryResponse } from "../types";
+export declare class CrewResource {
+    private client;
+    constructor(client: FortniteAPI);
+    /**
+     * Get current month's Crew Pack
+     */
+    getCurrent(): Promise<CrewPackResponse>;
+    /**
+     * Get Crew Pack history
+     */
+    getHistory(): Promise<CrewHistoryResponse>;
+}

package/dist/resources/crew.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrewResource = void 0;
+class CrewResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get current month's Crew Pack
+     */
+    async getCurrent() {
+        return this.client.request("/crew/current");
+    }
+    /**
+     * Get Crew Pack history
+     */
+    async getHistory() {
+        return this.client.request("/crew/history");
+    }
+}
+exports.CrewResource = CrewResource;

package/dist/resources/map.d.ts

@@ -0,0 +1,18 @@
+import { FortniteAPI } from "../client";
+import { MapResponse, MapImageResponse, MapHistoryResponse } from "../types";
+export declare class MapResource {
+    private client;
+    constructor(client: FortniteAPI);
+    /**
+     * Get current Fortnite map with POIs
+     */
+    getCurrent(): Promise<MapResponse>;
+    /**
+     * Get current map image URL
+     */
+    getImage(): Promise<MapImageResponse>;
+    /**
+     * Get historical map data
+     */
+    getHistory(): Promise<MapHistoryResponse>;
+}

package/dist/resources/map.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MapResource = void 0;
+class MapResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get current Fortnite map with POIs
+     */
+    async getCurrent() {
+        return this.client.request("/map");
+    }
+    /**
+     * Get current map image URL
+     */
+    async getImage() {
+        return this.client.request("/map/image");
+    }
+    /**
+     * Get historical map data
+     */
+    async getHistory() {
+        return this.client.request("/map/history");
+    }
+}
+exports.MapResource = MapResource;

package/dist/resources/news.d.ts

@@ -0,0 +1,22 @@
+import { FortniteAPI } from "../client";
+import { NewsResponse, BRNews, STWNews, CreativeNews, AllNews } from "../types";
+export declare class NewsResource {
+    private client;
+    constructor(client: FortniteAPI);
+    /**
+     * Get Battle Royale news
+     */
+    getBRNews(): Promise<NewsResponse<BRNews>>;
+    /**
+     * Get Save The World news
+     */
+    getSTWNews(): Promise<NewsResponse<STWNews>>;
+    /**
+     * Get Creative news
+     */
+    getCreativeNews(): Promise<NewsResponse<CreativeNews>>;
+    /**
+     * Get all news (BR, STW, Creative)
+     */
+    getAllNews(): Promise<NewsResponse<AllNews>>;
+}

package/dist/resources/news.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NewsResource = void 0;
+class NewsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get Battle Royale news
+     */
+    async getBRNews() {
+        return this.client.request("/news/br");
+    }
+    /**
+     * Get Save The World news
+     */
+    async getSTWNews() {
+        return this.client.request("/news/stw");
+    }
+    /**
+     * Get Creative news
+     */
+    async getCreativeNews() {
+        return this.client.request("/news/creative");
+    }
+    /**
+     * Get all news (BR, STW, Creative)
+     */
+    async getAllNews() {
+        return this.client.request("/news");
+    }
+}
+exports.NewsResource = NewsResource;

package/dist/resources/playlists.d.ts

@@ -0,0 +1,18 @@
+import { FortniteAPI } from "../client";
+import { PlaylistsResponse, ActivePlaylistsResponse, PlaylistResponse } from "../types";
+export declare class PlaylistsResource {
+    private client;
+    constructor(client: FortniteAPI);
+    /**
+     * Get all Fortnite playlists/gamemodes
+     */
+    getAll(): Promise<PlaylistsResponse>;
+    /**
+     * Get currently active playlists/gamemodes
+     */
+    getActive(): Promise<ActivePlaylistsResponse>;
+    /**
+     * Get a specific playlist by ID
+     */
+    getById(playlistId: string): Promise<PlaylistResponse>;
+}

package/dist/resources/playlists.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlaylistsResource = void 0;
+class PlaylistsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get all Fortnite playlists/gamemodes
+     */
+    async getAll() {
+        return this.client.request("/playlists", {}, "v2");
+    }
+    /**
+     * Get currently active playlists/gamemodes
+     */
+    async getActive() {
+        return this.client.request("/playlists/active", {}, "v2");
+    }
+    /**
+     * Get a specific playlist by ID
+     */
+    async getById(playlistId) {
+        return this.client.request(`/playlists/${playlistId}`, {}, "v2");
+    }
+}
+exports.PlaylistsResource = PlaylistsResource;

package/dist/resources/tournaments.d.ts

@@ -17,6 +17,9 @@ export declare class TournamentsResource {
      * Get global events with metadata
      */
     getGlobal(): Promise<any>;
+    getSessions(params: {
+        eventId: string;
+    }): Promise<any>;
     /**
      * Download events for a specific account
      * Requires user's own Fortnite token

package/dist/resources/tournaments.js

@@ -25,6 +25,10 @@ class TournamentsResource {
     async getGlobal() {
         return this.client.request("/events/global");
     }
+    async getSessions(params) {
+        const { eventId } = params;
+        return this.client.request(`/events/sessions?eventId=${eventId}`);
+    }
     /**
      * Download events for a specific account
      * Requires user's own Fortnite token

package/dist/types/index.d.ts

@@ -497,3 +497,150 @@ export interface EventRewards {
         currency?: string;
     }>;
 }
+export interface NewsResponse<T> {
+    status: number;
+    data: T;
+}
+export interface MOTD {
+    id: string;
+    title: string;
+    body: string;
+    image: string;
+    tileImage?: string;
+    videoURL?: string;
+    [key: string]: any;
+}
+export interface BRNews {
+    motds: MOTD[];
+    platform_motds?: MOTD[];
+    [key: string]: any;
+}
+export interface STWNews {
+    motds: MOTD[];
+    [key: string]: any;
+}
+export interface CreativeNews {
+    motds: MOTD[];
+    [key: string]: any;
+}
+export interface AllNews {
+    br: BRNews;
+    stw: STWNews;
+    creative: CreativeNews;
+    lastModified: string;
+}
+export interface CosmeticsResponse<T> {
+    status: number;
+    data: T;
+}
+export interface CosmeticsPaginatedResponse {
+    status: number;
+    data: CosmeticItem[];
+    pagination: {
+        page: number;
+        pageSize: number;
+        total: number;
+        totalPages: number;
+    };
+}
+export interface CosmeticItem {
+    id: string;
+    name: string;
+    description?: string;
+    type: string;
+    rarity: string;
+    series?: string;
+    set?: string;
+    images?: {
+        icon?: string;
+        featured?: string;
+        [key: string]: any;
+    };
+    introduction?: {
+        season?: number;
+        chapter?: number;
+    };
+    [key: string]: any;
+}
+export interface CosmeticsSearchParams {
+    page?: number;
+    pageSize?: number;
+    type?: string;
+    rarity?: string;
+    set?: string;
+    search?: string;
+}
+export interface CrewPackResponse {
+    status: number;
+    data: {
+        crew: {
+            name: string;
+            catalogEntries: any[];
+            refreshIntervalHrs: number;
+            dailyPurchaseHrs: number;
+        } | null;
+        count: number;
+        message: string;
+        lastModified: string;
+    };
+}
+export interface CrewHistoryResponse {
+    status: number;
+    data: {
+        history: any[];
+        count: number;
+        message: string;
+        lastModified: string;
+    };
+}
+export interface MapResponse {
+    status: number;
+    data: {
+        [key: string]: any;
+    };
+}
+export interface MapImageResponse {
+    status: number;
+    data: {
+        [key: string]: any;
+    };
+}
+export interface MapHistoryResponse {
+    status: number;
+    data: {
+        [key: string]: any;
+    };
+}
+export interface PlaylistsResponse {
+    status: number;
+    data: {
+        playlists: {
+            [playlistId: string]: Playlist;
+        };
+        conversion_config: any;
+        lastModified: string;
+    };
+}
+export interface ActivePlaylistsResponse {
+    status: number;
+    data: {
+        playlists: {
+            [playlistId: string]: Playlist;
+        };
+        count: number;
+        lastModified: string;
+    };
+}
+export interface PlaylistResponse {
+    status: number;
+    data: Playlist;
+}
+export interface Playlist {
+    id: string;
+    image: string;
+    playlist_name: string;
+    hidden: boolean;
+    _type: string;
+    lastModified?: string;
+    [key: string]: any;
+}

package/package.json

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