@spinzaf/freefire-api 1.0.0

package/proto/SetPlayerGalleryShowInfo.proto

@@ -0,0 +1,70 @@
+syntax = "proto3";
+
+package SetPlayerGalleryShowInfo;
+
+message request {
+    uint32 version = 1;
+    repeated GalleryShowInfo info_item = 2;
+}
+
+message request_single {
+    uint32 version = 1;
+    GalleryShowInfo info_item = 2;
+}
+
+message GalleryShowInfo {
+    GalleryShow_InfoType info_type = 1;
+    repeated GalleryShowInfoItem items = 2;
+}
+
+enum GalleryShow_InfoType {
+    InfoType_NONE = 0;
+    InfoType_ITEM = 1;
+    InfoType_BATTLEPASS = 2;
+    InfoType_ACHIEVEMENT = 3;
+    InfoType_WEAPONEXP = 4;
+    InfoType_SIGNATURE = 5;
+    InfoType_BUDDYINFO = 6;
+    InfoType_RANKINGSTATS = 7;
+    InfoType_LEADERBOARDTITLE = 8;
+    InfoType_CLANINFO = 9;
+    InfoType_CLANHISOTRYLEADERBOARD = 10;
+    InfoType_ACHIEVEMENT_STATS = 11;
+    InfoType_BADGE = 12;
+}
+
+message GalleryShowInfoItem {
+    uint32 type = 1;
+    uint32 sub_type = 2;
+    bool is_extra = 3;
+    uint32 position_x = 4;
+    uint32 position_y = 5;
+    GalleryShowExtraInfo extra_info = 6;
+}
+
+message GalleryShowExtraInfo {
+    string region = 1;
+    uint32 level = 2;
+    uint32 rank = 3;
+    uint32 max_level = 4;
+    uint64 friend_id = 5;
+    uint32 item_id = 6;
+    uint32 item_extra_id = 7;
+    uint32 value = 8;
+    string key = 9;
+    int64 expire_time = 10;
+    uint64 leaderboard_id = 11;
+    uint32 weapon_id = 12;
+    uint32 title_cfg_id = 13;
+    uint64 clan_id = 14;
+    int64 create_time = 15;
+    uint32 series_id = 16;
+    uint32 num_id = 17;
+    string clan_name = 18;
+    uint32 clan_level = 19;
+    uint32 clan_frame_id = 20;
+    uint32 clan_badge_id = 21;
+    bool clan_use_custom_badge = 22;
+    string clan_custom_badge = 23;
+    uint32 clan_glory_num = 24;
+}

package/test/all.js

@@ -0,0 +1,26 @@
+const { execSync } = require('child_process');
+
+const tests = [
+    'test/login.js',
+    'test/search.js',
+    'test/profile.js',
+    'test/stats.js',
+    'test/items.js'
+];
+
+console.log("Running all tests sequentially...\n");
+
+for (const testFile of tests) {
+    const testName = testFile.split('/')[1];
+    console.log(`-------------- ${testName}:`);
+
+    try {
+        execSync(`node ${testFile}`, { stdio: 'inherit' });
+        console.log("\n");
+    } catch (error) {
+        console.error(`[!] Test ${testName} failed.`);
+        process.exit(1);
+    }
+}
+
+console.log("All tests passed successfully!");

package/test/items.js

@@ -0,0 +1,51 @@
+const FreeFireAPI = require('../index');
+
+async function testItems() {
+    const targetUid = process.argv[2] || "12345678";
+    console.log(`Starting Items Test for UID: ${targetUid}...`);
+
+    const api = new FreeFireAPI();
+    try {
+        console.log(`Getting Player Items...`);
+        const items = await api.getPlayerItems(targetUid);
+
+        if (items) {
+            const itemList = items.items || {};
+            console.log(`\n--- Summary ---`);
+            console.log(`Nickname: ${items.basic_info ? items.basic_info.nickname : "-"}`);
+            console.log(`UID: ${items.basic_info ? items.basic_info.accountid : "-"}`);
+            console.log(`Outfit Items: ${itemList.outfit ? itemList.outfit.length : 0}`);
+
+            if (itemList.weapons && itemList.weapons.shown_skins) {
+                console.log(`Weapon Items: ${itemList.weapons.shown_skins.length}`);
+            }
+
+            if (itemList.skills && itemList.skills.equipped) {
+                console.log(`Skills Equipped: ${itemList.skills.equipped.length}`);
+                console.log(`Skills: ${itemList.skills.equipped.map(s => s.id).join(', ')}`);
+            }
+
+            if (itemList.pet) {
+                console.log(`Pet Name: ${itemList.pet.name || "None"}`);
+                if (itemList.pet.id) console.log(`Pet ID: ${itemList.pet.id.name || itemList.pet.id.id}`);
+            } else {
+                console.log(`Pet: None`);
+            }
+
+            if (itemList.outfit && itemList.outfit.length > 0) {
+                console.log(`\n--- First 5 Outfits ---`);
+                itemList.outfit.slice(0, 5).forEach(i => {
+                    console.log(`- ${i.name || "Unknown"} (ID: ${i.id})`);
+                });
+            }
+
+        } else {
+            console.log("Items fetch failed or empty.");
+        }
+
+    } catch (e) {
+        console.error("Items test failed:", e.message);
+    }
+}
+
+testItems();

package/test/login.js

@@ -0,0 +1,16 @@
+const FreeFireAPI = require('../index');
+
+async function testLogin() {
+    console.log("Starting Login Test...");
+    const api = new FreeFireAPI();
+    try {
+        const session = await api.login();
+        console.log("Login success!");
+        console.log(`Token: ${session.token.substring(0, 20)}...`);
+        console.log(`OpenID: ${session.openId}`);
+    } catch (e) {
+        console.error("Login failed:", e.message);
+    }
+}
+
+testLogin();

package/test/profile.js

@@ -0,0 +1,40 @@
+const FreeFireAPI = require('../index');
+
+async function testProfile() {
+    const targetUid = process.argv[2] || "12345678";
+    console.log(`Starting Profile Test for UID: ${targetUid}...`);
+
+    const api = new FreeFireAPI();
+    try {
+        const profile = await api.getPlayerProfile(targetUid);
+        if (profile && profile.basicinfo) {
+            console.log(`\n--- Basic Info ---`);
+            console.log(`Nickname: ${profile.basicinfo.nickname}`);
+            console.log(`Level: ${profile.basicinfo.level}`);
+            console.log(`EXP: ${profile.basicinfo.exp}`);
+            console.log(`Region: ${profile.basicinfo.region}`);
+            console.log(`Likes: ${profile.basicinfo.liked}`);
+            console.log(`Created At: ${new Date(profile.basicinfo.createat * 1000).toLocaleString()}`);
+            console.log(`Last Login: ${new Date(profile.basicinfo.lastloginat * 1000).toLocaleString()}`);
+
+            if (profile.claninfo) {
+                console.log(`\n--- Clan Info ---`);
+                console.log(`Clan Name: ${profile.claninfo.clanname}`);
+                console.log(`Clan ID: ${profile.claninfo.clanid}`);
+            }
+
+            if (profile.petinfo) {
+                console.log(`\n--- Pet Info ---`);
+                console.log(`Pet Name: ${profile.petinfo.name}`);
+                console.log(`Pet Level: ${profile.petinfo.level}`);
+            }
+
+        } else {
+            console.log("Profile data incomplete or not found.");
+        }
+    } catch (e) {
+        console.error("Profile test failed:", e.message);
+    }
+}
+
+testProfile();

package/test/search.js

@@ -0,0 +1,24 @@
+const FreeFireAPI = require('../index');
+
+async function testSearch() {
+    const searchName = process.argv[2] || "folaa";
+    console.log(`Starting Search Test for '${searchName}'...`);
+
+    const api = new FreeFireAPI();
+    try {
+        const searchResults = await api.searchAccount(searchName);
+        if (searchResults && searchResults.length > 0) {
+            console.log(`Found ${searchResults.length} players.`);
+            console.log(`Top Result: ${searchResults[0].nickname} (UID: ${searchResults[0].accountid})`);
+            searchResults.forEach((res, index) => {
+                console.log(`[${index + 1}] ${res.nickname} - UID: ${res.accountid} - LVL: ${res.level}`);
+            });
+        } else {
+            console.log("No players found.");
+        }
+    } catch (e) {
+        console.error("Search failed:", e.message);
+    }
+}
+
+testSearch();

package/test/stats.js

@@ -0,0 +1,47 @@
+const FreeFireAPI = require('../index');
+
+async function testStats() {
+    const targetUid = process.argv[2] || "16207002";
+    console.log(`Starting Stats Test for UID: ${targetUid}...`);
+
+    const api = new FreeFireAPI();
+
+    const printStats = (title, data) => {
+        console.log(`\n--- ${title} ---`);
+        if (!data) {
+            console.log("No data returned.");
+            return;
+        }
+        if (data.solostats) console.log("Solo:", JSON.stringify(data.solostats, (k, v) => (v && v.value ? v.value : v)));
+        if (data.duostats) console.log("Duo:", JSON.stringify(data.duostats, (k, v) => (v && v.value ? v.value : v)));
+        if (data.quadstats) console.log("Squad:", JSON.stringify(data.quadstats, (k, v) => (v && v.value ? v.value : v)));
+
+        if (!data.solostats && !data.duostats && !data.quadstats) {
+            console.log("Data:", JSON.stringify(data, null, 2));
+        }
+    };
+
+    try {
+        // await api.login();
+        console.log("Fetching BR Career...");
+        const brCareer = await api.getPlayerStats(targetUid, 'br', 'career');
+        printStats("BR Career", brCareer);
+
+        console.log("Fetching BR Ranked...");
+        const brRanked = await api.getPlayerStats(targetUid, 'br', 'ranked');
+        printStats("BR Ranked", brRanked);
+
+        console.log("Fetching CS Career...");
+        const csCareer = await api.getPlayerStats(targetUid, 'cs', 'career');
+        printStats("CS Career", csCareer);
+
+        console.log("Fetching CS Ranked...");
+        const csRanked = await api.getPlayerStats(targetUid, 'cs', 'ranked');
+        printStats("CS Ranked", csRanked);
+
+    } catch (e) {
+        console.error("Stats test failed:", e.message);
+    }
+}
+
+testStats();