discord-bots-manager 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 discord-bot-manager
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# discord-bot-manager
+
+Spawn, monitor, and manage multiple Discord bot processes from a single Node.js process.
+
+Each bot runs in its own isolated child process (`child_process.fork`), so a crash in one bot never affects the others. The manager handles auto-restarts, IPC communication, and graceful shutdown.
+
+## Features
+
+- **Multi-process isolation** — each bot is a separate OS process
+- **Auto-restart** — configurable delay and max retry count
+- **IPC** — send messages between the manager and any bot process
+- **Lifecycle events** — `start`, `ready`, `crash`, `restart`, `stop`, `error`
+- **Graceful shutdown** — sends `shutdown` message, then SIGKILL after 5s timeout
+- **Status reporting** — query PID, status, uptime, and restart count per bot
+- **TypeScript** — full type declarations included
+
+## Install
+
+```bash
+npm install discord-bot-manager
+```
+
+> **Peer dependency:** requires `discord.js@^14`
+
+## Quick Start
+
+### Manager (index.js)
+
+```ts
+import { Manager } from 'discord-bot-manager'
+
+const manager = new Manager({
+  bots: [
+    {
+      name: 'mod-bot',
+      token: process.env.MOD_BOT_TOKEN!,
+      script: './bot.js',
+    },
+    {
+      name: 'music-bot',
+      token: process.env.MUSIC_BOT_TOKEN!,
+      script: './bot.js',
+      restartDelay: 5000,
+      maxRestarts: 3,
+    },
+  ],
+})
+
+manager.on('bot:ready', (name) => console.log(`${name} is online`))
+manager.on('bot:crash', ({ name, code }) =>
+  console.error(`${name} crashed (exit ${code})`))
+
+manager.startAll()
+
+process.on('SIGINT', () => {
+  manager.stopAll()
+  process.exit(0)
+})
+```
+
+### Bot worker (bot.js)
+
+This is the script the manager forks. It receives `BOT_NAME`, `BOT_TOKEN`, and `BOT_INTENTS` via environment variables.
+
+```ts
+import { Client, GatewayIntentBits } from 'discord.js'
+import type { IPCMessage } from 'discord-bot-manager'
+
+const client = new Client({
+  intents: Number(process.env.BOT_INTENTS) || GatewayIntentBits.Guilds,
+})
+
+client.once('ready', () => {
+  // Notify the manager that the bot is online
+  process.send?.({ type: 'ready', from: 'worker', botName: process.env.BOT_NAME, timestamp: Date.now() })
+})
+
+// Listen for messages from the manager
+process.on('message', (msg: IPCMessage) => {
+  if (msg.type === 'shutdown') {
+    client.destroy()
+    process.exit(0)
+  }
+})
+
+client.login(process.env.BOT_TOKEN)
+```
+
+## API
+
+### `Manager`
+
+| Method | Description |
+|---|---|
+| `startAll()` | Start all registered bots |
+| `start(name)` | Start a specific bot |
+| `stopAll()` | Stop all bots gracefully |
+| `stop(name)` | Stop a specific bot |
+| `restartAll()` | Restart all bots |
+| `restart(name)` | Restart a specific bot |
+| `addBot(config)` | Register a new bot at runtime |
+| `removeBot(name)` | Stop and remove a bot |
+| `sendTo(name, type, payload?)` | Send IPC message to a specific bot |
+| `broadcast(type, payload?)` | Send IPC message to all bots |
+| `status()` | Get status array for all bots |
+| `statusOf(name)` | Get status of one bot |
+
+### Events
+
+| Event | Payload |
+|---|---|
+| `bot:start` | `string` (name) |
+| `bot:ready` | `string` (name) |
+| `bot:crash` | `{ name, code, signal }` |
+| `bot:restart` | `string` (name) |
+| `bot:stop` | `string` (name) |
+| `bot:error` | `{ name, error }` |
+| `bot:message` | `(msg: IPCMessage, name: string)` |
+
+### `BotConfig`
+
+| Field | Type | Default | Description |
+|---|---|---|---|
+| `name` | `string` | — | Unique identifier for the bot |
+| `token` | `string` | — | Discord bot token (injected as `BOT_TOKEN` env) |
+| `script` | `string` | — | Path to the worker script |
+| `intents` | `number` | `0` | Discord.js intents bitfield |
+| `env` | `Record<string, string>` | `{}` | Extra env variables |
+| `restartDelay` | `number` | `2000` | Delay before restart (ms) |
+| `maxRestarts` | `number` | `Infinity` | Max auto-restart attempts |
+
+## Examples
+
+Clone the repo and run:
+
+```bash
+npm install
+npm run build
+node examples/manager.js
+```
+
+See the [examples](./examples) directory for a complete manager + worker setup.
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## License
+
+MIT

package/dist/BotProcess.d.ts

@@ -0,0 +1,26 @@
+import { ChildProcess } from 'child_process';
+import { EventEmitter } from 'events';
+import { BotConfig, BotStatus, IPCMessage } from './types';
+export declare class BotProcess extends EventEmitter {
+    config: BotConfig;
+    process: ChildProcess | null;
+    restarts: number;
+    lastRestart: number | null;
+    startTime: number | null;
+    private manualStop;
+    private restartTimer;
+    constructor(config: BotConfig);
+    get pid(): number | null;
+    get status(): BotStatus['status'];
+    get uptime(): number | null;
+    toStatus(): BotStatus;
+    start(): void;
+    stop(): void;
+    restart(): void;
+    send(msg: Omit<IPCMessage, 'from'> & {
+        from?: 'manager' | 'worker';
+    }): boolean;
+    private scheduleRestart;
+    private clearRestartTimer;
+}
+//# sourceMappingURL=BotProcess.d.ts.map

package/dist/BotProcess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotProcess.d.ts","sourceRoot":"","sources":["../src/BotProcess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAQ,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAE1D,qBAAa,UAAW,SAAQ,YAAY;IACnC,MAAM,EAAE,SAAS,CAAA;IACjB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAO;IACnC,QAAQ,SAAI;IACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAO;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAO;IACtC,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,YAAY,CAA6C;gBAErD,MAAM,EAAE,SAAS;IAK7B,IAAI,GAAG,IAAI,MAAM,GAAG,IAAI,CAEvB;IAED,IAAI,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,CAOhC;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAI1B;IAED,QAAQ,IAAI,SAAS;IAWrB,KAAK,IAAI,IAAI;IA2Cb,IAAI,IAAI,IAAI;IAYZ,OAAO,IAAI,IAAI;IAef,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO;IAK9E,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,iBAAiB;CAM1B"}

package/dist/BotProcess.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BotProcess = void 0;
+const child_process_1 = require("child_process");
+const events_1 = require("events");
+class BotProcess extends events_1.EventEmitter {
+    config;
+    process = null;
+    restarts = 0;
+    lastRestart = null;
+    startTime = null;
+    manualStop = false;
+    restartTimer = null;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    get pid() {
+        return this.process?.pid ?? null;
+    }
+    get status() {
+        if (this.process === null)
+            return 'stopped';
+        if (this.process.killed)
+            return 'stopped';
+        if (this.process.exitCode !== null && !this.manualStop)
+            return 'crashed';
+        if (this.process.exitCode !== null)
+            return 'stopped';
+        if (this.startTime === null)
+            return 'starting';
+        return 'running';
+    }
+    get uptime() {
+        if (this.startTime === null)
+            return null;
+        if (this.process === null || this.process.killed)
+            return (Date.now() - this.startTime);
+        return Date.now() - this.startTime;
+    }
+    toStatus() {
+        return {
+            name: this.config.name,
+            pid: this.pid,
+            status: this.status,
+            uptime: this.uptime,
+            restarts: this.restarts,
+            lastRestart: this.lastRestart
+        };
+    }
+    start() {
+        this.manualStop = false;
+        this.startTime = Date.now();
+        this.lastRestart = Date.now();
+        const env = {
+            ...process.env,
+            ...this.config.env,
+            BOT_NAME: this.config.name,
+            BOT_TOKEN: this.config.token,
+            BOT_INTENTS: String(this.config.intents ?? 0)
+        };
+        this.process = (0, child_process_1.fork)(this.config.script, [], {
+            env: env,
+            stdio: ['pipe', 'pipe', 'pipe', 'ipc']
+        });
+        this.process.on('message', (msg) => {
+            if (msg.type === 'ready') {
+                this.emit('ready', this.config.name);
+            }
+            this.emit('message', msg, this.config.name);
+        });
+        this.process.on('exit', (code, signal) => {
+            const crashed = !this.manualStop;
+            this.emit('exit', { name: this.config.name, code, signal, crashed });
+            if (crashed) {
+                this.emit('crash', { name: this.config.name, code, signal });
+                this.scheduleRestart();
+            }
+            this.process = null;
+            this.startTime = null;
+        });
+        this.process.on('error', (err) => {
+            this.emit('error', { name: this.config.name, error: err.message });
+        });
+        this.emit('start', this.config.name);
+    }
+    stop() {
+        this.manualStop = true;
+        this.clearRestartTimer();
+        if (!this.process)
+            return;
+        this.send({ type: 'shutdown', from: 'manager', botName: this.config.name, timestamp: Date.now() });
+        const killTimeout = setTimeout(() => {
+            this.process?.kill('SIGKILL');
+        }, 5000);
+        this.process.once('exit', () => clearTimeout(killTimeout));
+        this.process?.disconnect();
+    }
+    restart() {
+        this.manualStop = true;
+        this.clearRestartTimer();
+        if (this.process) {
+            this.process.once('exit', () => {
+                this.manualStop = false;
+                this.start();
+            });
+            this.stop();
+        }
+        else {
+            this.manualStop = false;
+            this.start();
+        }
+    }
+    send(msg) {
+        if (!this.process || !this.process.connected)
+            return false;
+        return this.process.send({ ...msg, from: 'manager' });
+    }
+    scheduleRestart() {
+        const delay = this.config.restartDelay ?? 2000;
+        const max = this.config.maxRestarts ?? Infinity;
+        if (this.restarts >= max) {
+            this.emit('error', { name: this.config.name, error: `Max restarts (${max}) reached` });
+            return;
+        }
+        this.restarts++;
+        this.restartTimer = setTimeout(() => {
+            this.emit('restart', this.config.name);
+            this.start();
+        }, delay);
+    }
+    clearRestartTimer() {
+        if (this.restartTimer) {
+            clearTimeout(this.restartTimer);
+            this.restartTimer = null;
+        }
+    }
+}
+exports.BotProcess = BotProcess;
+//# sourceMappingURL=BotProcess.js.map

package/dist/BotProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotProcess.js","sourceRoot":"","sources":["../src/BotProcess.ts"],"names":[],"mappings":"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"}

package/dist/Manager.d.ts

@@ -0,0 +1,21 @@
+import { EventEmitter } from 'events';
+import { BotConfig, BotStatus, ManagerOptions } from './types';
+import { BotProcess } from './BotProcess';
+export declare class Manager extends EventEmitter {
+    bots: Map<string, BotProcess>;
+    private maxConcurrentRestarts;
+    constructor(options: ManagerOptions);
+    addBot(config: BotConfig): BotProcess;
+    removeBot(name: string): boolean;
+    startAll(): void;
+    start(name: string): void;
+    stopAll(): void;
+    stop(name: string): void;
+    restartAll(): void;
+    restart(name: string): void;
+    sendTo(name: string, type: string, payload?: unknown): boolean;
+    broadcast(type: string, payload?: unknown): void;
+    status(): BotStatus[];
+    statusOf(name: string): BotStatus | null;
+}
+//# sourceMappingURL=Manager.d.ts.map

package/dist/Manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Manager.d.ts","sourceRoot":"","sources":["../src/Manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,qBAAa,OAAQ,SAAQ,YAAY;IAChC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAY;IAChD,OAAO,CAAC,qBAAqB,CAAQ;gBAEzB,OAAO,EAAE,cAAc;IAQnC,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU;IAkBrC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQhC,QAAQ,IAAI,IAAI;IAMhB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB,OAAO,IAAI,IAAI;IAMf,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB,UAAU,IAAI,IAAI;IAMlB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO;IAM9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAMhD,MAAM,IAAI,SAAS,EAAE;IAIrB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;CAGzC"}

package/dist/Manager.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Manager = void 0;
+const events_1 = require("events");
+const BotProcess_1 = require("./BotProcess");
+class Manager extends events_1.EventEmitter {
+    bots = new Map();
+    maxConcurrentRestarts;
+    constructor(options) {
+        super();
+        this.maxConcurrentRestarts = options.maxConcurrentRestarts ?? 3;
+        for (const botCfg of options.bots) {
+            this.addBot(botCfg);
+        }
+    }
+    addBot(config) {
+        if (this.bots.has(config.name)) {
+            throw new Error(`Bot "${config.name}" already registered`);
+        }
+        const bp = new BotProcess_1.BotProcess(config);
+        this.bots.set(config.name, bp);
+        bp.on('start', (name) => this.emit('bot:start', name));
+        bp.on('stop', (name) => this.emit('bot:stop', name));
+        bp.on('crash', (data) => this.emit('bot:crash', data));
+        bp.on('restart', (name) => this.emit('bot:restart', name));
+        bp.on('ready', (name) => this.emit('bot:ready', name));
+        bp.on('error', (data) => this.emit('bot:error', data));
+        bp.on('message', (msg, name) => this.emit('bot:message', msg, name));
+        return bp;
+    }
+    removeBot(name) {
+        const bp = this.bots.get(name);
+        if (!bp)
+            return false;
+        bp.stop();
+        bp.removeAllListeners();
+        return this.bots.delete(name);
+    }
+    startAll() {
+        for (const bp of this.bots.values()) {
+            bp.start();
+        }
+    }
+    start(name) {
+        this.bots.get(name)?.start();
+    }
+    stopAll() {
+        for (const bp of this.bots.values()) {
+            bp.stop();
+        }
+    }
+    stop(name) {
+        this.bots.get(name)?.stop();
+    }
+    restartAll() {
+        for (const bp of this.bots.values()) {
+            bp.restart();
+        }
+    }
+    restart(name) {
+        this.bots.get(name)?.restart();
+    }
+    sendTo(name, type, payload) {
+        const bp = this.bots.get(name);
+        if (!bp)
+            return false;
+        return bp.send({ type, payload, from: 'manager', botName: name, timestamp: Date.now() });
+    }
+    broadcast(type, payload) {
+        for (const [name, bp] of this.bots) {
+            bp.send({ type, payload, from: 'manager', botName: name, timestamp: Date.now() });
+        }
+    }
+    status() {
+        return Array.from(this.bots.values()).map(b => b.toStatus());
+    }
+    statusOf(name) {
+        return this.bots.get(name)?.toStatus() ?? null;
+    }
+}
+exports.Manager = Manager;
+//# sourceMappingURL=Manager.js.map

package/dist/Manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Manager.js","sourceRoot":"","sources":["../src/Manager.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Manager } from './Manager';
+export { BotProcess } from './BotProcess';
+export type { BotConfig, BotStatus, ManagerOptions, IPCMessage, BotEvent } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BotProcess = exports.Manager = void 0;
+var Manager_1 = require("./Manager");
+Object.defineProperty(exports, "Manager", { enumerable: true, get: function () { return Manager_1.Manager; } });
+var BotProcess_1 = require("./BotProcess");
+Object.defineProperty(exports, "BotProcess", { enumerable: true, get: function () { return BotProcess_1.BotProcess; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAmC;AAA1B,kGAAA,OAAO,OAAA;AAChB,2CAAyC;AAAhC,wGAAA,UAAU,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+export interface BotConfig {
+    name: string;
+    token: string;
+    intents?: number;
+    script: string;
+    env?: Record<string, string>;
+    restartDelay?: number;
+    maxRestarts?: number;
+}
+export interface BotStatus {
+    name: string;
+    pid: number | null;
+    status: 'starting' | 'running' | 'stopped' | 'crashed';
+    uptime: number | null;
+    restarts: number;
+    lastRestart: number | null;
+}
+export interface ManagerOptions {
+    bots: BotConfig[];
+    maxConcurrentRestarts?: number;
+}
+export interface IPCMessage {
+    type: string;
+    payload?: unknown;
+    from: 'manager' | 'worker';
+    botName: string;
+    timestamp: number;
+}
+export type BotEvent = 'start' | 'stop' | 'crash' | 'restart' | 'ready' | 'error' | 'message';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;IACtD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,EAAE,CAAA;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAA"}

package/dist/types.js

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

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "discord-bots-manager",
+  "version": "0.1.0",
+  "description": "Spawn and manage multiple Discord bot processes from a single manager using child_process.fork()",
+"main": "dist/index.js",
+"types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build",
+    "example": "npm run build && node examples/manager.js"
+  },
+  "keywords": [
+    "discord",
+    "bot",
+    "manager",
+    "process-manager",
+    "discord.js",
+    "cluster",
+    "shard",
+    "sharding",
+    "multiprocess",
+    "child-process",
+    "fork",
+    "process-management",
+    "bot-manager",
+    "nodejs",
+    "typescript",
+    "discord-bot"
+  ],
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/freepinkg/discord-bot-manager.git"
+  },
+  "bugs": {
+    "url": "https://github.com/freepinkg/discord-bot-manager/issues"
+  },
+  "homepage": "https://github.com/freepinkg/discord-bot-manager",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0"
+  },
+  "peerDependencies": {
+    "discord.js": "^14.0.0"
+  }
+}