fnapi-js 1.1.2 → 2.0.0-beta.0

package/package.json

@@ -1,20 +1,54 @@
 {
   "name": "fnapi-js",
-  "version": "1.1.2",
-  "description": "Unofficial API Wrapper for https://fortnite-api.com/",
-  "main": "src/index.js",
-  "types": "index.d.ts",
+  "version": "2.0.0-beta.0",
+  "description": "Zero-dependency TypeScript wrapper for the public Fortnite APIs with a full Epic Games account-service, realtime (XMPP/EOS), party, MCP and item-shop/gifting layer",
   "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "docs.md",
+    "config.example.json",
+    "LICENSE"
+  ],
+  "sideEffects": false,
   "scripts": {
-    "test": "echo hi"
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:live": "vitest run --config vitest.live.config.ts",
+    "cli": "tsx tools/cli.ts",
+    "generate:mcp": "tsx tools/generate-mcp-operations.ts",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
   },
   "keywords": [
-    "api",
-    "wrapper",
     "fortnite",
     "fortnite-api",
+    "api",
+    "wrapper",
+    "typescript",
+    "cosmetics",
+    "item-shop",
     "lobbybot",
-    "fortnite-bot"
+    "fortnite-bot",
+    "epic-games"
   ],
   "author": "AjaxFNC-YT",
   "license": "MIT",
@@ -26,13 +60,20 @@
     "url": "https://github.com/AjaxFNC-YT/fnapi-js/issues"
   },
   "homepage": "https://github.com/AjaxFNC-YT/fnapi-js#readme",
-  "dependencies": {
-    "axios": "^1.9.0"
-  },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18.0.0"
   },
   "devDependencies": {
-    "jest": "^29.5.0"
+    "@types/node": "^26.2.0",
+    "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^3.0.5",
+    "tsup": "^8.3.6",
+    "tsx": "^4.23.12",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5",
+    "ws": "^8.21.3"
+  },
+  "allowScripts": {
+    "esbuild@0.27.7": true
   }
 }

package/src/client/Aes.js

@@ -1,23 +0,0 @@
-class Aes {
-    constructor(apiClient) {
-        this.client = apiClient;
-    }
-
-    async get() {
-        const requestData = await this.client.request('GET', '/v2/aes');
-
-        const data = requestData.body().data;
-        const build = data.build.replace(/\\u002B/g, '+').replace(/\\u002F/g, '/');
-        const mainKey = data.mainKey;
-        const dynamicKeys = data.dynamicKeys;
-
-        return {
-            build: build,
-            mainKey: mainKey,
-            dynamicKeys: dynamicKeys
-        }
-
-    }
-}
-
-export default Aes;

package/src/client/ApiClient.js

@@ -1,114 +0,0 @@
-import axios from 'axios';
-import Response from '../http/Response.js';
-import Cosmetics from './Cosmetics.js';
-import Aes from './Aes.js'
-import CreatorCode from './CreatorCode.js';
-import Map from './Map.js';
-import News from './News.js';
-import Playlists from './Playlists.js';
-import Shop from './Shop.js';
-import Stats from './Stats.js';
-import Banners from './Banners.js';
-import Misc from './Misc.js';
-
-class ApiClient {
-    constructor(config = {}) {
-        this.baseUrl = 'https://fortnite-api.com';
-        this.options = {
-            timeout: 30000,
-            headers: {},
-            ...config
-        };
-
-        if (config.apiKey) {
-            this.options.headers['Authorization'] = `${config.apiKey}`;
-        }
-
-        this.client = axios.create({
-            baseURL: this.baseUrl,
-            timeout: this.options.timeout,
-            headers: this.options.headers
-        });
-
-        this.cosmetics = new Cosmetics(this);
-        this.aes = new Aes(this)
-        this.sac = new CreatorCode(this);
-        this.news = new News(this);
-        this.map = new Map(this);
-        this.playlists = new Playlists(this);
-        this.stats = new Stats(this);
-        this.shop = new Shop(this);
-        this.banners = new Banners(this);
-        this.misc = new Misc(this);
-    }
-
-    async request(method, path, data = null, options = {}) {
-        const maxRetries = 3;
-        let lastError;
-
-        for (let attempt = 1; attempt <= maxRetries; attempt++) {
-            try {
-                const response = await this.client.request({
-                    method,
-                    url: path,
-                    data,
-                    headers: { ...this.options.headers, ...options.headers },
-                    params: { ...this.options.query, ...options.params },
-                    timeout: 60000
-                });
-
-                return new Response(
-                    response.status,
-                    response.data,
-                    response.headers
-                );
-            } catch (error) {
-                lastError = error;
-
-                if (error.response) {
-                    return new Response(
-                        error.response.status,
-                        error.response.data,
-                        error.response.headers
-                    );
-                }
-
-                if (error.code === 'ECONNRESET' || error.code === 'ETIMEDOUT' || error.code === 'ECONNABORTED') {
-                    if (attempt < maxRetries) {
-                        console.log(`Request failed (${error.code}). Retrying... (${attempt}/${maxRetries})`);
-                        await new Promise(resolve => setTimeout(resolve, 1000 * attempt));
-                        continue;
-                    }
-                }
-
-                throw error;
-            }
-        }
-
-        throw lastError;
-    }
-
-    setHeader(key, value) {
-        this.options.headers[key] = value;
-        this.client.defaults.headers[key] = value;
-    }
-
-    getBaseUrl() {
-        return this.baseUrl;
-    }
-
-    _getTypeValue(item) {
-        if (!item.type?.backendValue) return null;
-
-        const typeMapping = {
-            'AthenaCharacter': 'outfit',
-            'AthenaDance': 'emote',
-            'AthenaPickaxe': 'pickaxe',
-            'AthenaBackpack': 'backpack'
-        };
-
-        return typeMapping[item.type.backendValue] || null;
-    }
-}
-
-export default ApiClient;

package/src/client/Banners.js

@@ -1,23 +0,0 @@
-class Banners {
-    constructor(apiClient) {
-        this.client = apiClient;
-    }
-
-    async get() {
-        const requestData = await this.client.request('GET', '/v1/banners');
-
-        if (!requestData.isSuccess()) throw new Error(requestData.body().error);
-        const data = requestData.body().data;
-        return data;
-    }
-
-    async getColors() {
-        const requestData = await this.client.request('GET', '/v1/banners/colors');
-
-        if (!requestData.isSuccess()) throw new Error(requestData.body().error);
-        const data = requestData.body().data;
-        return data;
-    }
-}
-
-export default Banners;

package/src/client/Cosmetics.js

@@ -1,103 +0,0 @@
-import RequestFlags from '../enums/RequestFlags.js';
-import SearchOptions from '../types/SearchOptions.js';
-
-class Cosmetics {
-    constructor(apiClient) {
-        this.client = apiClient;
-    }
-
-    async getAll(flags = RequestFlags.none()) {
-        return await this.client.request('GET', '/v2/cosmetics/br', null, {
-            params: { 
-                ...flags && { responseFlags: flags }
-            }
-        });
-    }
-
-    async getAllNew(flags = RequestFlags.none()) {
-        return await this.client.request('GET', '/v2/cosmetics/new', null, {
-            params: { 
-                ...flags && { responseFlags: flags }
-            }
-        });
-    }
-
-    async getAllTracks(flags = RequestFlags.none()) {
-        return await this.client.request('GET', '/v2/cosmetics/tracks', null, {
-            params: { 
-                ...flags && { responseFlags: flags }
-            }
-        });
-    }
-
-    async getAllInstrument(flags = RequestFlags.none()) {
-        return await this.client.request('GET', '/v2/cosmetics/instruments', null, {
-            params: { 
-                ...flags && { responseFlags: flags }
-            }
-        });
-    }
-
-    async getAllCars(flags = RequestFlags.none()) {
-        return await this.client.request('GET', '/v2/cosmetics/cars', null, {
-            params: { 
-                ...flags && { responseFlags: flags }
-            }
-        });
-    }
-
-    async getAllLego(flags = RequestFlags.none()) {
-        return await this.client.request('GET', '/v2/cosmetics/lego', null, {
-            params: { 
-                ...flags && { responseFlags: flags }
-            }
-        });
-    }
-
-    async getAllLegoKits(flags = RequestFlags.none()) {
-        return await this.client.request('GET', '/v2/cosmetics/lego/kits', null, {
-            params: { 
-                ...flags && { responseFlags: flags }
-            }
-        });
-    }
-
-    async getAllBeans(flags = RequestFlags.none()) {
-        return await this.client.request('GET', '/v2/cosmetics/beans', null, {
-            params: { 
-                ...flags && { responseFlags: flags }
-            }
-        });
-    }
-
-    async getById(cosmeticId, flags = RequestFlags.none()) {
-        if (!cosmeticId) throw new Error('Cosmetic ID is required');
-        
-        return await this.client.request('GET', `/v2/cosmetics/br/${cosmeticId}`, null, {
-            params: { 
-                ...flags && { responseFlags: flags }
-            }
-        });
-    }
-
-    async search(searchOptions = new SearchOptions(), flags = RequestFlags.none(), searchAll = true) {
-        const params = searchOptions.build();
-        if (searchAll) {
-            return await this.client.request('GET', '/v2/cosmetics/br/search/all', null, {
-                params: {
-                    ...params,
-                    ...flags && { responseFlags: flags }
-                }
-            });
-        } else {
-            return await this.client.request('GET', '/v2/cosmetics/br/search', null, {
-                params: {
-                    ...params,
-                    ...flags && { responseFlags: flags }
-                }
-            });
-        }
-    }
-}
-
-export default Cosmetics;

package/src/client/CreatorCode.js

@@ -1,19 +0,0 @@
-class CreatorCode {
-    constructor(apiClient) {
-        this.client = apiClient;
-    }
-
-    async get(code) {
-        if (!code) throw new Error('Code parameter is required');
-        
-        const requestData = await this.client.request('GET', '/v2/creatorcode', null, {
-            params: {
-                name: code
-            }
-        });
-        if (!requestData.isSuccess()) throw new Error(requestData.body().error);
-        return requestData.body().data;
-    }
-}
-
-export default CreatorCode;

package/src/client/Map.js

@@ -1,15 +0,0 @@
-class Map {
-    constructor(apiClient) {
-        this.client = apiClient;
-    }
-
-    async get() {
-        const requestData = await this.client.request('GET', '/v1/map');
-
-        if (!requestData.isSuccess()) throw new Error(requestData.body().error);
-        const data = requestData.body().data;
-        return data;
-    }
-}
-
-export default Map;

package/src/client/Misc.js

@@ -1,21 +0,0 @@
-import RequestFlags from '../enums/RequestFlags.js';
-import SearchOptions from '../types/SearchOptions.js';
-
-class Misc {
-    constructor(apiClient) {
-        this.client = apiClient;
-    }
-
-    async fixPath(path) {
-        return path
-            .replace(/^FortniteGame\/Content/, '/Game')
-            .replace(/FortniteGame\/Plugins\/GameFeatures\/BRCosmetics\/Content/, '/BRCosmetics')
-            .replace(/FortniteGame\/Plugins\/GameFeatures\/CosmeticShoes\/Content/, '/CosmeticShoes')
-            .split('/')
-            .slice(0, -1)
-            .join('/');
-    }
-
-}
-
-export default Misc;

package/src/client/News.js

@@ -1,16 +0,0 @@
-class News {
-    constructor(apiClient) {
-        this.client = apiClient;
-    }
-
-    async get() {
-        const requestData = await this.client.request('GET', '/v2/news');
-        const data = requestData.body().data;
-
-        if (!requestData.isSuccess()) throw new Error(requestData.body().error);
-        return data;
-
-    }
-}
-
-export default News;

package/src/client/Playlists.js

@@ -1,25 +0,0 @@
-class Playlists {
-    constructor(apiClient) {
-        this.client = apiClient;
-    }
-
-    async all() {
-        const requestData = await this.client.request('GET', '/v1/playlists');
-
-        const data = requestData.body().data;
-        if (!requestData.isSuccess()) throw new Error(requestData.body().error);
-        return data;
-    }
-
-    async byId(id) {
-        if(!id) throw new Error("Id is required.")
-
-        const requestData = await this.client.request('GET', `/v1/playlists/${id}`);
-
-        const data = requestData.body().data;
-        if (!requestData.isSuccess()) throw new Error(requestData.body().error);
-        return data;
-    }
-}
-
-export default Playlists;

package/src/client/Shop.js

@@ -1,17 +0,0 @@
-class Shop {
-    constructor(apiClient) {
-        this.client = apiClient;
-    }
-
-    async get() {
-        const requestData = await this.client.request('GET', '/v2/shop');
-
-        const data = requestData.body().data;
-
-        if (!requestData.isSuccess()) throw new Error(requestData.body().error);
-        return data;
-
-    }
-}
-
-export default Shop;

package/src/client/Stats.js

@@ -1,50 +0,0 @@
-class Stats {
-    constructor(apiClient) {
-        this.client = apiClient;
-    }
-
-    async get(name, accountType, timeWindow, image) {
-        if (!this.client.options.apiKey) throw new Error('API key is required for stats');
-        if (!name) throw new Error('Name parameter is required');
-        if (!accountType) throw new Error('Account type parameter is required');
-        if (!timeWindow) throw new Error('Time window parameter is required');
-
-        const requestData = await this.client.request('GET', '/v2/stats/br/v2', null, {
-            params: {
-                name: name,
-                accountType: accountType,
-                timeWindow: timeWindow,
-                image: image || 'all'
-            }
-        });
-
-        if (!requestData.isSuccess()) {
-            throw new Error(requestData.body().error || 'Failed to fetch stats');
-        }
-
-        return requestData.body().data;
-
-    }
-
-    async byId(id, timeWindow, image) {
-        if (!this.client.options.apiKey) throw new Error('API key is required for stats');
-        if (!id) throw new Error('ID parameter is required');
-        if (!timeWindow) throw new Error('Time window parameter is required');
-
-        const requestData = await this.client.request('GET', `/v2/stats/br/v2/${id}`, null, {
-            params: {
-                timeWindow: timeWindow,
-                image: image || 'all'
-            }
-        });
-
-        if (!requestData.isSuccess()) {
-            throw new Error(requestData.body().error || 'Failed to fetch stats');
-        }
-
-        return requestData.body().data;
-
-    }
-}
-
-export default Stats;