@yaelouuu/fortnite-api 1.0.0

package/README.md

@@ -0,0 +1,47 @@
+# Fortnite API SDK
+
+JavaScript/TypeScript SDK for the Fortnite API by Royal Arena.
+
+## Installation
+
+```bash
+npm install @yaelouuu/fortnite-api
+```
+
+## Quick Start
+
+```typescript
+import { FortniteAPI } from "@yaelouuu/fortnite-api";
+
+const client = new FortniteAPI({
+  apiKey: "your-api-key-here",
+});
+
+// Get current shop
+const shop = await client.shop.getCurrent();
+
+// Get tournament leaderboard
+const leaderboard = await client.tournaments.getLeaderboard({
+  eventId: "epicgames_...",
+  eventWindowId: "S37_...",
+  page: 0,
+});
+
+// Get profile stats
+const stats = await client.profiles.getStats("PlayerName");
+
+// Get season info
+const season = await client.calendar.getCurrentSeason();
+```
+
+## Features
+
+- ✅ Full TypeScript support
+- ✅ Promise-based async/await API
+- ✅ Automatic error handling
+- ✅ Built-in retry logic (optional)
+- ✅ Tree-shakeable
+
+## Documentation
+
+Full API documentation: https://api.api-fortnite.com/documentation

package/dist/client.d.ts

@@ -0,0 +1,23 @@
+import { ShopResource } from "./resources/shop";
+import { TournamentsResource } from "./resources/tournaments";
+import { ProfilesResource } from "./resources/profiles";
+import { CalendarResource } from "./resources/calendar";
+import { BundlesResource } from "./resources/bundles";
+export interface ClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+export declare class FortniteAPI {
+    private apiKey;
+    private baseUrl;
+    shop: ShopResource;
+    tournaments: TournamentsResource;
+    profiles: ProfilesResource;
+    calendar: CalendarResource;
+    bundles: BundlesResource;
+    constructor(options: ClientOptions);
+    /**
+     * Internal method to make HTTP requests
+     */
+    request<T>(endpoint: string, options?: RequestInit): Promise<T>;
+}

package/dist/client.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FortniteAPI = void 0;
+const shop_1 = require("./resources/shop");
+const tournaments_1 = require("./resources/tournaments");
+const profiles_1 = require("./resources/profiles");
+const calendar_1 = require("./resources/calendar");
+const errors_1 = require("./errors");
+const bundles_1 = require("./resources/bundles");
+class FortniteAPI {
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = options.baseUrl || "https://prod.api-fortnite.com/api/v1";
+        // this.baseUrl = options.baseUrl || "http://localhost:4321/api/v1";
+        // Initialize resources
+        this.shop = new shop_1.ShopResource(this);
+        this.tournaments = new tournaments_1.TournamentsResource(this);
+        this.profiles = new profiles_1.ProfilesResource(this);
+        this.calendar = new calendar_1.CalendarResource(this);
+        this.bundles = new bundles_1.BundlesResource(this);
+    }
+    /**
+     * Internal method to make HTTP requests
+     */
+    async request(endpoint, options = {}) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                "x-api-key": this.apiKey,
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+        });
+        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);
+        }
+        const data = await response.json();
+        return data;
+    }
+}
+exports.FortniteAPI = FortniteAPI;

package/dist/errors.d.ts

@@ -0,0 +1,5 @@
+export declare class FortniteAPIError extends Error {
+    status: number;
+    data: any;
+    constructor(message: string, status: number, data?: any);
+}

package/dist/errors.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FortniteAPIError = void 0;
+class FortniteAPIError extends Error {
+    constructor(message, status, data) {
+        super(message);
+        this.name = "FortniteAPIError";
+        this.status = status;
+        this.data = data;
+    }
+}
+exports.FortniteAPIError = FortniteAPIError;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { FortniteAPI } from "./client";
+export * from "./types";
+export { FortniteAPIError } from "./errors";

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FortniteAPIError = exports.FortniteAPI = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "FortniteAPI", { enumerable: true, get: function () { return client_1.FortniteAPI; } });
+__exportStar(require("./types"), exports);
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "FortniteAPIError", { enumerable: true, get: function () { return errors_1.FortniteAPIError; } });

package/dist/resources/bundles.d.ts

@@ -0,0 +1,14 @@
+import { FortniteAPI } from "../client";
+import { TournamentsBundle, ShopBundle } from "../types";
+export declare class BundlesResource {
+    private client;
+    constructor(client: FortniteAPI);
+    /**
+     * Get current season information
+     */
+    getBundlesTournament(): Promise<TournamentsBundle>;
+    /**
+     * Get current season information
+     */
+    getBundlesShop(): Promise<ShopBundle>;
+}

package/dist/resources/bundles.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BundlesResource = void 0;
+class BundlesResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get current season information
+     */
+    async getBundlesTournament() {
+        return this.client.request("/assets/bundles/tournaments");
+    }
+    /**
+     * Get current season information
+     */
+    async getBundlesShop() {
+        return this.client.request("/assets/bundles/shop");
+    }
+}
+exports.BundlesResource = BundlesResource;

package/dist/resources/calendar.d.ts

@@ -0,0 +1,10 @@
+import { FortniteAPI } from "../client";
+import { SeasonInfo } from "../types";
+export declare class CalendarResource {
+    private client;
+    constructor(client: FortniteAPI);
+    /**
+     * Get current season information
+     */
+    getCurrentSeason(): Promise<SeasonInfo>;
+}

package/dist/resources/calendar.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalendarResource = void 0;
+class CalendarResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get current season information
+     */
+    async getCurrentSeason() {
+        return this.client.request("/season");
+    }
+}
+exports.CalendarResource = CalendarResource;

package/dist/resources/profiles.d.ts

@@ -0,0 +1,22 @@
+import { FortniteAPI } from "../client";
+import { Profile, ProfileStats } from "../types";
+export declare class ProfilesResource {
+    private client;
+    constructor(client: FortniteAPI);
+    /**
+     * Get profile progress by display name
+     */
+    getProgress(displayName: string): Promise<any>;
+    /**
+     * Get profile stats by display name
+     */
+    getStats(displayName: string): Promise<ProfileStats>;
+    /**
+     * Get account info by ID
+     */
+    getAccount(accountId: string): Promise<Profile>;
+    /**
+     * Get multiple display names
+     */
+    getDisplayNames(accountIds: string[]): Promise<Record<string, string>>;
+}

package/dist/resources/profiles.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProfilesResource = void 0;
+class ProfilesResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get profile progress by display name
+     */
+    async getProgress(displayName) {
+        return this.client.request(`/profile/progress?displayName=${displayName}`);
+    }
+    /**
+     * Get profile stats by display name
+     */
+    async getStats(displayName) {
+        return this.client.request(`/profile/stats?displayName=${displayName}`);
+    }
+    /**
+     * Get account info by ID
+     */
+    async getAccount(accountId) {
+        return this.client.request(`/account/${accountId}`);
+    }
+    /**
+     * Get multiple display names
+     */
+    async getDisplayNames(accountIds) {
+        const ids = accountIds.join(",");
+        return this.client.request(`/displaynames/multiple?ids=${ids}`);
+    }
+}
+exports.ProfilesResource = ProfilesResource;

package/dist/resources/shop.d.ts

@@ -0,0 +1,10 @@
+import { FortniteAPI } from "../client";
+import { Shop } from "../types";
+export declare class ShopResource {
+    private client;
+    constructor(client: FortniteAPI);
+    /**
+     * Get current shop items
+     */
+    getCurrent(): Promise<Shop>;
+}

package/dist/resources/shop.js

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

package/dist/resources/tournaments.d.ts

@@ -0,0 +1,31 @@
+import { FortniteAPI } from "../client";
+import { Leaderboard } from "../types";
+export declare class TournamentsResource {
+    private client;
+    constructor(client: FortniteAPI);
+    /**
+     * Get current events
+     */
+    getCurrent(params?: {
+        accountId?: string;
+    }): Promise<any>;
+    /**
+     * Get past events
+     */
+    getPast(params?: {
+        accountId?: string;
+    }): Promise<any>;
+    /**
+     * Get global events
+     */
+    getGlobal(): Promise<any>;
+    /**
+     * Get tournament leaderboard
+     */
+    getLeaderboard(params: {
+        eventId: string;
+        eventWindowId: string;
+        page?: number;
+        leaderboardDef?: string;
+    }): Promise<Leaderboard>;
+}

package/dist/resources/tournaments.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TournamentsResource = void 0;
+class TournamentsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get current events
+     */
+    async getCurrent(params) {
+        const queryString = params?.accountId
+            ? `?accountId=${params.accountId}`
+            : "";
+        return this.client.request(`/events/data/current${queryString}`);
+    }
+    /**
+     * Get past events
+     */
+    async getPast(params) {
+        const queryString = params?.accountId
+            ? `?accountId=${params.accountId}`
+            : "";
+        return this.client.request(`/events/data/past${queryString}`);
+    }
+    /**
+     * Get global events
+     */
+    async getGlobal() {
+        return this.client.request("/events/global");
+    }
+    /**
+     * Get tournament leaderboard
+     */
+    async getLeaderboard(params) {
+        const { eventId, eventWindowId, page = 0, leaderboardDef } = params;
+        const query = new URLSearchParams({
+            eventId,
+            eventWindowId,
+            page: page.toString(),
+            ...(leaderboardDef && { leaderboardDef }),
+        }).toString();
+        return this.client.request(`/events/leaderboard?${query}`);
+    }
+}
+exports.TournamentsResource = TournamentsResource;

package/dist/types/index.d.ts

@@ -0,0 +1,60 @@
+export interface Shop {
+    date: string;
+    bundles: ShopBundle[];
+}
+export interface ShopBundle {
+    id: string;
+    name: string;
+    price: number;
+    items: ShopItem[];
+}
+export interface TournamentsBundle {
+}
+export interface ShopItem {
+    id: string;
+    name: string;
+    type: string;
+    rarity: string;
+    images: {
+        icon: string;
+        featured?: string;
+    };
+}
+export interface Tournament {
+    eventId: string;
+    eventName: string;
+    beginTime: string;
+    endTime: string;
+    regions: string[];
+}
+export interface Leaderboard {
+    gameId: string;
+    eventId: string;
+    eventWindowId: string;
+    page: number;
+    totalPages: number;
+    entries: LeaderboardEntry[];
+}
+export interface LeaderboardEntry {
+    teamAccountIds: string[];
+    teamAccountDisplayNames: string[];
+    pointsEarned: number;
+    rank: number;
+    sessionHistory: any[];
+}
+export interface Profile {
+    id: string;
+    displayName: string;
+    email?: string;
+    country?: string;
+}
+export interface ProfileStats {
+    accountId: string;
+    stats: Record<string, number>;
+}
+export interface SeasonInfo {
+    seasonDateBegin: string;
+    seasonDateEnd: string;
+    seasonNumber: number;
+    exTime: number;
+}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Oauth types

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@yaelouuu/fortnite-api",
+  "version": "1.0.0",
+  "description": "SDK for Fortnite Tournaments API by Royal Arena - Author : yaelouuu",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "fortnite",
+    "api",
+    "tournaments",
+    "sdk"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}