fnlb 1.1.5 → 1.1.6

package/README.md

@@ -1,162 +1,162 @@
-# 🚀 FNLB – Self-Host Your Own Fortnite Bot
-
-Easily run your own bot using **[FNLB](https://fnlb.net)**, a powerful and scalable system for managing Fortnite bots.  
-Whether you're running one bot or hundreds, FNLB gives you full control.  
-
-## 📦 Installation
-
-Install the latest version via **npm install**:
-
-```bash
-npm install fnlb@latest
-```
-
-Using **[bun](https://bun.sh)**? Install the latest version via **bun install**:
-
-```bash
-bun install fnlb@latest
-```
-
-## 🔗 Useful Links
-
-- 🌐 **[FNLB Website](https://fnlb.net)**
-- 📖 **[FNLB Documentation](https://docs.fnlb.net/introduction)**
-- 📄 **[FNLB Changelog](https://docs.fnlb.net/bots/changelog)**
-- 🗨️ **[FNLB Discord Server](https://fnlb.net/discord)**
-
-## 🤖 Starting a Single Bot
-
-Get started with a single bot using your [FNLB API token](https://app.fnlb.net/account):
-
-```ts
-import FNLB from 'fnlb';
-
-const fnlb = new FNLB();
-
-await fnlb.start({
-    apiToken: 'your-api-token', // 🔑 Replace with your actual token from https://app.fnlb.net/account
-    categories: ['your-category-id'] // Get the category of your bot on https://app.fnlb.net/bots -> Click on your bot -> About this bot -> Category ID
-});
-```
-
-## 🔁 Running Multiple Bots (Same Shard)
-
-Run multiple bots in a **single subprocess** using the `botsPerShard` option:
-
-```ts
-import FNLB from 'fnlb';
-
-const fnlb = new FNLB();
-
-await fnlb.start({
-    apiToken: 'your-api-token',
-    categories: ['your-category-id'],
-    botsPerShard: 10 // 🧱 Spawns max 10 bots
-});
-```
-
-## 🧩 Using Multiple Shards (Subprocesses)
-
-Scale even more by spawning multiple **shards** (subprocesses) with multiple bots each:
-
-```ts
-import FNLB from 'fnlb';
-
-const fnlb = new FNLB();
-
-await fnlb.start({
-    apiToken: 'your-api-token',
-    categories: ['your-category-id'],
-    numberOfShards: 2,     // 2 shards 🧩
-    botsPerShard: 10       // max 10 bots per shard 🤖
-});
-```
-
-> 💡 Total bots: `numberOfShards × botsPerShard`  
-> In this example: 2 × 10 = **20 bots max**
-
-## 🗂️ Launching Bots Across Multiple Categories
-
-Want to run bots from different FNLB categories? Just add them to the `categories` array:
-
-```ts
-import FNLB from 'fnlb';
-
-const fnlb = new FNLB();
-
-await fnlb.start({
-    apiToken: 'your-api-token',
-    categories: ['category-id-1', 'category-id-2'], // 🔄 Multi-category support
-    numberOfShards: 2,
-    botsPerShard: 10
-});
-```
-
-## ⛔ Stopping All Bots
-
-Shut everything down cleanly using the `stop()` method:
-
-```ts
-import FNLB from 'fnlb';
-
-const fnlb = new FNLB();
-
-await fnlb.start({
-    apiToken: 'your-api-token',
-    numberOfShards: 2,
-    botsPerShard: 10
-});
-
-await fnlb.stop(); // 🛑 Stops all shards and bots
-```
-
-## 🏷️ Naming Your Cluster
-
-Customize your cluster with a unique name using the `clusterName` option:
-
-```ts
-import FNLB from 'fnlb';
-
-const fnlb = new FNLB({ clusterName: 'MyAwesomeCluster' });
-
-await fnlb.start({
-    apiToken: 'your-api-token'
-});
-```
-
-## 🔄 Auto-Restart Every Hour (Optional)
-
-Want to keep things fresh? Here's how to restart your bots automatically every hour:
-
-```ts
-import FNLB from 'fnlb';
-
-const fnlb = new FNLB();
-
-async function startFNLB() {
-    await fnlb.start({
-        apiToken: 'your-api-token',
-        numberOfShards: 1,
-        botsPerShard: 5,
-        categories: ['your-category-id']
-    });
-}
-
-async function restartFNLB() {
-    console.log('🔁 Restarting FNLB...');
-    await fnlb.stop();
-    await startFNLB();
-}
-
-await startFNLB();
-
-// ⏱️ Restart every hour (3600000 ms)
-setInterval(restartFNLB, 3_600_000);
-```
-
-## 🗨️ Join the Community
-
-Need help, support, or just want to chat with other developers?  
-Come hang out with us on Discord! 👇
-
+# 🚀 FNLB – Self-Host Your Own Fortnite Bot
+
+Easily run your own bot using **[FNLB](https://fnlb.net)**, a powerful and scalable system for managing Fortnite bots.  
+Whether you're running one bot or hundreds, FNLB gives you full control.  
+
+## 📦 Installation
+
+Install the latest version via **npm install**:
+
+```bash
+npm install fnlb@latest
+```
+
+Using **[bun](https://bun.sh)**? Install the latest version via **bun install**:
+
+```bash
+bun install fnlb@latest
+```
+
+## 🔗 Useful Links
+
+- 🌐 **[FNLB Website](https://fnlb.net)**
+- 📖 **[FNLB Documentation](https://docs.fnlb.net/introduction)**
+- 📄 **[FNLB Changelog](https://docs.fnlb.net/bots/changelog)**
+- 🗨️ **[FNLB Discord Server](https://fnlb.net/discord)**
+
+## 🤖 Starting a Single Bot
+
+Get started with a single bot using your [FNLB API token](https://app.fnlb.net/account):
+
+```ts
+import FNLB from 'fnlb';
+
+const fnlb = new FNLB();
+
+await fnlb.start({
+    apiToken: 'your-api-token', // 🔑 Replace with your actual token from https://app.fnlb.net/account
+    categories: ['your-category-id'] // Get the category of your bot on https://app.fnlb.net/bots -> Click on your bot -> About this bot -> Category ID
+});
+```
+
+## 🔁 Running Multiple Bots (Same Shard)
+
+Run multiple bots in a **single subprocess** using the `botsPerShard` option:
+
+```ts
+import FNLB from 'fnlb';
+
+const fnlb = new FNLB();
+
+await fnlb.start({
+    apiToken: 'your-api-token',
+    categories: ['your-category-id'],
+    botsPerShard: 10 // 🧱 Spawns max 10 bots
+});
+```
+
+## 🧩 Using Multiple Shards (Subprocesses)
+
+Scale even more by spawning multiple **shards** (subprocesses) with multiple bots each:
+
+```ts
+import FNLB from 'fnlb';
+
+const fnlb = new FNLB();
+
+await fnlb.start({
+    apiToken: 'your-api-token',
+    categories: ['your-category-id'],
+    numberOfShards: 2,     // 2 shards 🧩
+    botsPerShard: 10       // max 10 bots per shard 🤖
+});
+```
+
+> 💡 Total bots: `numberOfShards × botsPerShard`  
+> In this example: 2 × 10 = **20 bots max**
+
+## 🗂️ Launching Bots Across Multiple Categories
+
+Want to run bots from different FNLB categories? Just add them to the `categories` array:
+
+```ts
+import FNLB from 'fnlb';
+
+const fnlb = new FNLB();
+
+await fnlb.start({
+    apiToken: 'your-api-token',
+    categories: ['category-id-1', 'category-id-2'], // 🔄 Multi-category support
+    numberOfShards: 2,
+    botsPerShard: 10
+});
+```
+
+## ⛔ Stopping All Bots
+
+Shut everything down cleanly using the `stop()` method:
+
+```ts
+import FNLB from 'fnlb';
+
+const fnlb = new FNLB();
+
+await fnlb.start({
+    apiToken: 'your-api-token',
+    numberOfShards: 2,
+    botsPerShard: 10
+});
+
+await fnlb.stop(); // 🛑 Stops all shards and bots
+```
+
+## 🏷️ Naming Your Cluster
+
+Customize your cluster with a unique name using the `clusterName` option:
+
+```ts
+import FNLB from 'fnlb';
+
+const fnlb = new FNLB({ clusterName: 'MyAwesomeCluster' });
+
+await fnlb.start({
+    apiToken: 'your-api-token'
+});
+```
+
+## 🔄 Auto-Restart Every Hour (Optional)
+
+Want to keep things fresh? Here's how to restart your bots automatically every hour:
+
+```ts
+import FNLB from 'fnlb';
+
+const fnlb = new FNLB();
+
+async function startFNLB() {
+    await fnlb.start({
+        apiToken: 'your-api-token',
+        numberOfShards: 1,
+        botsPerShard: 5,
+        categories: ['your-category-id']
+    });
+}
+
+async function restartFNLB() {
+    console.log('🔁 Restarting FNLB...');
+    await fnlb.stop();
+    await startFNLB();
+}
+
+await startFNLB();
+
+// ⏱️ Restart every hour (3600000 ms)
+setInterval(restartFNLB, 3_600_000);
+```
+
+## 🗨️ Join the Community
+
+Need help, support, or just want to chat with other developers?  
+Come hang out with us on Discord! 👇
+
 [![Join FNLB on Discord](https://discord.com/api/guilds/1106879710744543303/widget.png?style=banner3)](https://fnlb.net/discord)

package/dist/index.js

@@ -1 +1 @@
-import{fork as u}from"node:child_process";import{createHash as f}from"node:crypto";import{mkdir as g,readFile as m,writeFile as w}from"node:fs/promises";import{resolve as S}from"node:path";class l{static wait(t){return new Promise((s)=>setTimeout(s,t))}}class d{config;activeProcesses=new Map;packageName=`${process.versions.bun?"zenith-bun":"zenith"}`;isLoaded=!1;shouldRestart=!0;runId=0;constructor(t){this.config=t}async start(t){await this.stop(),this.shouldRestart=!0,this.runId++;let s=this.runId;if(!t?.apiToken)throw new Error("[FNLB ShardingManager] Please provide a FNLB API token.");await this.update();let a=t.numberOfShards??1,h=(~~(Math.random()*1e4)).toString(36)+"fnlb"+(~~(Date.now()/1000)).toString(36);for(let i=0;i<a;i++){let e=`${h}-${i.toString().padStart(2,"0")}`,n=await this.startShard(t,e,s);this.activeProcesses.set(e,n)}}async stop(){if(this.shouldRestart=!1,this.runId++,this.activeProcesses.size===0)return;this.log("Stopping all active processes...");for(let[t,s]of this.activeProcesses)this.log(`Stopping process with ID: ${t}`),s.kill();this.activeProcesses.clear(),this.log("All processes stopped.")}async startShard(t,s,a){if(await this.update(),!t?.apiToken||t.apiToken.length<10)throw new Error("[FNLB ShardingManager] Please provide a valid FNLB API token.");this.log("Starting shard with ID:",s);let h=u(`./.fnlb/${this.packageName}.mjs`,[],{env:{...process.env,FORCE_COLOR:"1",SHARD_ID:s,API_TOKEN:t.apiToken,CATEGORIES:t.categories?.join(","),BOTS_PER_SHARD:(t.botsPerShard??1).toString(),HIDE_USERNAMES:t.hideUsernames?"true":"false",HIDE_EMAILS:t.hideEmails?"true":"false",LOG_LEVEL:t.logLevel,CLUSTER_ID:this.config?.clusterName?.trim().replace(/ +(?= )/g,"").toLowerCase().replaceAll(" ","-")??"unknown",CLUSTER_NAME:this.config?.clusterName?.trim()},stdio:["inherit","pipe","pipe","ipc"]});if(!this.config?.disableSubProcessLogs)h.stdout?.on("data",(i)=>{let e=i.toString("utf8");process.stdout.write(e),this.config?.onSubProcessLogMessage?.({timestamp:Date.now(),content:e,format:0})});if(!this.config?.disableSubProcessErrorLogs)h.stderr?.on("data",(i)=>{let e=i.toString("utf8");process.stderr.write(e),this.config?.onSubProcessLogMessage?.({timestamp:Date.now(),content:e,format:4})});return h.on("close",async(i)=>{if(this.activeProcesses.delete(s),this.shouldRestart&&a===this.runId){if(i===0)this.warn("Child process exited with code:",i,"(OK)");else this.error("Child process exited with code:",i?.toString()??"none");await l.wait(1e4);let e=await this.startShard(t,s,a);this.activeProcesses.set(s,e)}else this.log(`Child process ${s} stopped.`)}),h}async update(){if(this.isLoaded)return;let t=S(`./.fnlb/${this.packageName}.mjs`),s=await m(t,"utf-8").catch(()=>null),a=this.config?.maxDownloadRetries||1/0,h=this.config?.maxBackoffMs||60000;this.log(s?"Checking for updates...":"Downloading FNLB...");let i=`https://dist.fnlb.net/packages/${this.packageName}/release`,e,n=0,c=1000;while(n<a)try{let r=await fetch(i);if(!r.ok)throw new Error(`Status code: ${r.status}`);e=await r.json();break}catch(r){let o=Math.min(c*2,h);if(n++,this.error("Update error:",r),this.warn(`Check for updates attempt ${n} failed: ${r.message}. Retrying in ${o>=60000?`${~~(o/60000)}m`:`${~~(o/1000)}s`}...`),n>=a)break;await new Promise((p)=>setTimeout(p,c)),c=o}if(!e){if(s){this.warn("Failed to check for updates. Using existing local version."),this.isLoaded=!0,this.success("Loaded existing FNLB version");return}throw new Error("[FNLB ShardingManager] Failed to check for updates and no local file found.")}if(s){if(f("sha256").update(s).digest("hex")===e.hash){this.success(`FNLB v${e.version} is up to date`),this.isLoaded=!0,this.success(`Finished loading FNLB v${e.version}`);return}this.log(`Downloading update for FNLB v${e.version}`)}n=0,c=1000;while(n<a)try{let r=await fetch(e.url);if(!r.ok)throw new Error(`Download failed with status ${r.status}`);let o=await r.text();if(f("sha256").update(o).digest("hex")!==e.hash)throw new Error("Downloaded file hash mismatch...");await g(".fnlb",{recursive:!0}),await w(t,o),this.isLoaded=!0,this.success(`Finished loading FNLB v${e.version}`);return}catch(r){let o=Math.min(c*2,h);n++,this.error("Download error:",r),this.warn(`Download attempt ${n} failed: ${r.message}. Retrying in ${o>=60000?`${~~(o/60000)}m`:`${~~(o/1000)}s`}...`),await l.wait(c),c=o}if(s){this.warn("Max retries reached. Using existing local version."),this.isLoaded=!0,this.success("Loaded existing FNLB version");return}throw new Error(`[FNLB ShardingManager] Failed to download and verify update after ${n} attempts`)}log(...t){if(!this.config?.disableLogs)console.log("[FNLB ShardingManager]",...t),this.config?.onLogMessage?.({timestamp:Date.now(),content:t.join(" "),format:0})}success(...t){if(!this.config?.disableLogs)console.log("[FNLB ShardingManager] [OK]",...t),this.config?.onLogMessage?.({timestamp:Date.now(),content:t.join(" "),format:1})}warn(...t){if(!this.config?.disableErrorLogs)console.warn("[FNLB ShardingManager] [WRN]",...t),this.config?.onLogMessage?.({timestamp:Date.now(),content:t.join(" "),format:3})}error(...t){if(!this.config?.disableErrorLogs)console.error("[FNLB ShardingManager] [ERR]",...t),this.config?.onLogMessage?.({timestamp:Date.now(),content:t.join(" "),format:4})}}var L;((a)=>{a.Info="INFO";a.Debug="DEBUG"})(L||={});var C=d;export{C as default,L as LogLevel};
+import{fork as u}from"node:child_process";import{createHash as f}from"node:crypto";import{mkdir as g,readFile as m,writeFile as w}from"node:fs/promises";import{resolve as S}from"node:path";class d{static wait(t){return new Promise((r)=>setTimeout(r,t))}}class l{config;activeProcesses=new Map;packageName=`${process.versions.bun?"zenith-bun":"zenith"}`;isLoaded=!1;shouldRestart=!0;runId=0;constructor(t){this.config=t}async start(t){await this.stop(),this.shouldRestart=!0,this.runId++;let r=this.runId;if(!t?.apiToken)throw new Error("[FNLB ShardingManager] Please provide a FNLB API token.");await this.update();let o=t.numberOfShards??1,h=(~~(Math.random()*1e4)).toString(36)+"fnlb"+(~~(Date.now()/1000)).toString(36);for(let i=0;i<o;i++){let e=`${h}-${i.toString().padStart(2,"0")}`,n=await this.startShard(t,e,r);this.activeProcesses.set(e,n)}}async stop(){if(this.shouldRestart=!1,this.runId++,this.activeProcesses.size===0)return;this.log("Stopping all active shards...");for(let[t,r]of this.activeProcesses)this.log(`Stopping shard with ID: ${t}`),r.kill();this.activeProcesses.clear(),this.log("All shards stopped.")}async startShard(t,r,o){if(await this.update(),!t?.apiToken||t.apiToken.length<10)throw new Error("[FNLB ShardingManager] Please provide a valid FNLB API token.");this.log("Starting shard with ID:",r);let h=u(`./.fnlb/${this.packageName}.mjs`,[],{env:{...process.env,FORCE_COLOR:"1",SHARD_ID:r,API_TOKEN:t.apiToken,CATEGORIES:t.categories?.join(","),BOTS_PER_SHARD:(t.botsPerShard??1).toString(),HIDE_USERNAMES:t.hideUsernames?"true":"false",HIDE_EMAILS:t.hideEmails?"true":"false",LOG_LEVEL:t.logLevel,CLUSTER_ID:this.config?.clusterName?.trim().replace(/ +(?= )/g,"").toLowerCase().replaceAll(" ","-")??"unknown",CLUSTER_NAME:this.config?.clusterName?.trim()},stdio:["inherit","pipe","pipe","ipc"]});if(!this.config?.disableSubProcessLogs)h.stdout?.on("data",(i)=>{let e=i.toString("utf8");process.stdout.write(e),this.config?.onSubProcessLogMessage?.({timestamp:Date.now(),content:e,format:0})});if(!this.config?.disableSubProcessErrorLogs)h.stderr?.on("data",(i)=>{let e=i.toString("utf8");process.stderr.write(e),this.config?.onSubProcessLogMessage?.({timestamp:Date.now(),content:e,format:4})});return h.on("close",async(i)=>{if(this.activeProcesses.delete(r),this.shouldRestart&&o===this.runId){if(i===0)this.warn("Shard exited with code:",i);else this.error("Shard exited with code:",i?.toString()??"none");this.log("Trying to restart shard..."),await d.wait(1e4);let e=await this.startShard(t,r,o);this.activeProcesses.set(r,e)}else this.log(`Shard ${r} stopped.`)}),h}async update(){if(this.isLoaded)return;let t=S(`./.fnlb/${this.packageName}.mjs`),r=await m(t,"utf-8").catch(()=>null),o=this.config?.maxDownloadRetries||1/0,h=this.config?.maxBackoffMs||60000;this.log(r?"Checking for updates...":"Downloading FNLB...");let i=`https://dist.fnlb.net/packages/${this.packageName}/release`,e,n=0,c=1000;while(n<o)try{let s=await fetch(i);if(!s.ok)throw new Error(`Status code: ${s.status}`);e=await s.json();break}catch(s){let a=Math.min(c*2,h);if(n++,this.error("Update error:",s),this.warn(`Check for updates attempt ${n} failed: ${s.message}. Retrying in ${a>=60000?`${~~(a/60000)}m`:`${~~(a/1000)}s`}...`),n>=o)break;await new Promise((p)=>setTimeout(p,c)),c=a}if(!e){if(r){this.warn("Failed to check for updates. Using existing local version."),this.isLoaded=!0,this.success("Loaded existing FNLB version");return}throw new Error("[FNLB ShardingManager] Failed to check for updates and no local file found.")}if(r){if(f("sha256").update(r).digest("hex")===e.hash){this.success(`FNLB v${e.version} is up to date`),this.isLoaded=!0,this.success(`Finished loading FNLB v${e.version}`);return}this.log(`Downloading update for FNLB v${e.version}`)}n=0,c=1000;while(n<o)try{let s=await fetch(e.url);if(!s.ok)throw new Error(`Download failed with status ${s.status}`);let a=await s.text();if(f("sha256").update(a).digest("hex")!==e.hash)throw new Error("Downloaded file hash mismatch...");await g(".fnlb",{recursive:!0}),await w(t,a),this.isLoaded=!0,this.success(`Finished loading FNLB v${e.version}`);return}catch(s){let a=Math.min(c*2,h);n++,this.error("Download error:",s),this.warn(`Download attempt ${n} failed: ${s.message}. Retrying in ${a>=60000?`${~~(a/60000)}m`:`${~~(a/1000)}s`}...`),await d.wait(c),c=a}if(r){this.warn("Max retries reached. Using existing local version."),this.isLoaded=!0,this.success("Loaded existing FNLB version");return}throw new Error(`[FNLB ShardingManager] Failed to download and verify update after ${n} attempts`)}log(...t){if(!this.config?.disableLogs)console.log("[FNLB ShardingManager]",...t),this.config?.onLogMessage?.({timestamp:Date.now(),content:t.join(" "),format:0})}success(...t){if(!this.config?.disableLogs)console.log("[FNLB ShardingManager] [OK]",...t),this.config?.onLogMessage?.({timestamp:Date.now(),content:t.join(" "),format:1})}warn(...t){if(!this.config?.disableErrorLogs)console.warn("[FNLB ShardingManager] [WRN]",...t),this.config?.onLogMessage?.({timestamp:Date.now(),content:t.join(" "),format:3})}error(...t){if(!this.config?.disableErrorLogs)console.error("[FNLB ShardingManager] [ERR]",...t),this.config?.onLogMessage?.({timestamp:Date.now(),content:t.join(" "),format:4})}}var L;((o)=>{o.Info="INFO";o.Debug="DEBUG"})(L||={});var M=l;export{M as default,L as LogLevel};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "fnlb",
-	"version": "1.1.5",
+	"version": "1.1.6",
 	"author": "FNLB",
 	"main": "dist/index.js",
 	"homepage": "https://fnlb.net",