multi-dc 0.1.2 → 0.1.6

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_CONFIG_FILES: readonly ["multi-discord.config.ts", "multi-discord.config.js", "multi-discord.config.mts", "multi-discord.config.mjs", "multi-discord.config.cts", "multi-discord.config.cjs", "multi-discord.js.config.ts", "multi-discord.js.config.js", "multi-discord.js.config.mts", "multi-discord.js.config.mjs", "multi-discord.js.config.cts", "multi-discord.js.config.cjs"];
+export declare const DEFAULT_BOT_ENTRIES: readonly ["src/bot.ts", "src/bot.js", "bot.ts", "bot.js", "index.ts", "index.js", "src/index.ts", "src/index.js"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,yWAavB,CAAC;AAEX,eAAO,MAAM,mBAAmB,mHAStB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,25 @@
+export const DEFAULT_CONFIG_FILES = [
+    "multi-discord.config.ts",
+    "multi-discord.config.js",
+    "multi-discord.config.mts",
+    "multi-discord.config.mjs",
+    "multi-discord.config.cts",
+    "multi-discord.config.cjs",
+    "multi-discord.js.config.ts",
+    "multi-discord.js.config.js",
+    "multi-discord.js.config.mts",
+    "multi-discord.js.config.mjs",
+    "multi-discord.js.config.cts",
+    "multi-discord.js.config.cjs",
+];
+export const DEFAULT_BOT_ENTRIES = [
+    "src/bot.ts",
+    "src/bot.js",
+    "bot.ts",
+    "bot.js",
+    "index.ts",
+    "index.js",
+    "src/index.ts",
+    "src/index.js",
+];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,yBAAyB;IACzB,yBAAyB;IACzB,0BAA0B;IAC1B,0BAA0B;IAC1B,0BAA0B;IAC1B,0BAA0B;IAC1B,4BAA4B;IAC5B,4BAA4B;IAC5B,6BAA6B;IAC7B,6BAA6B;IAC7B,6BAA6B;IAC7B,6BAA6B;CACrB,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,YAAY;IACZ,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,UAAU;IACV,cAAc;IACd,cAAc;CACN,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { BotProjectConfig, CreateBotClientContext, MultiBotConfig, } from "./types.js";
+export { runBots, runBotsFromConfigFile, shutdownBots } from "./runtime.js";
+import type { MultiBotConfig } from "./types.js";
+export declare function defineMultiBotConfig(config: MultiBotConfig): MultiBotConfig;
+//# 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,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAE3E"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { runBots, runBotsFromConfigFile, shutdownBots } from "./runtime.js";
+export function defineMultiBotConfig(config) {
+    return config;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5E,MAAM,UAAU,oBAAoB,CAAC,MAAsB;IACzD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+type StarterLanguage = "ts" | "js";
+export interface InitOptions {
+    dir: string;
+    language: StarterLanguage;
+}
+export declare function initProject(options: InitOptions): Promise<string>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":";AAIA,KAAK,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAuID,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAKvE"}

package/dist/init.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+import { mkdir, readdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+function packageJsonTemplate(language) {
+    const isTs = language === "ts";
+    const scripts = isTs
+        ? `"dev": "multi-dc run",
+    "build": "tsc -p tsconfig.json"`
+        : `"dev": "multi-dc run"`;
+    const devDependencies = isTs
+        ? `,
+  "devDependencies": {
+    "typescript": "^5.7.3"
+  }`
+        : "";
+    return `{
+  "name": "my-multi-bots",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    ${scripts}
+  },
+  "dependencies": {
+    "discord.js": "^14.19.3",
+    "multi-dc": "latest"
+  }${devDependencies}
+}
+`;
+}
+function tsconfigTemplate() {
+    return `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "include": [
+    "bots/**/*.ts",
+    "multi-discord.config.ts"
+  ]
+}
+`;
+}
+function configTemplate(language) {
+    const extension = language === "ts" ? "ts" : "js";
+    return `import { defineMultiBotConfig } from "multi-dc";
+
+export default defineMultiBotConfig({
+  envFile: ".env",
+  botsBasePath: "bots",
+  onError: "continue",
+  bots: [
+    { name: "bot1", path: "bot1", entry: "src/bot.${extension}", tokenEnv: "TKN1" },
+    { name: "bot2", path: "bot2", entry: "src/bot.${extension}", tokenEnv: "TKN2" },
+    { name: "bot3", path: "bot3", entry: "src/bot.${extension}", tokenEnv: "TKN3" }
+  ]
+});
+`;
+}
+function botTemplate() {
+    return `import { Client, GatewayIntentBits } from "discord.js";
+
+export function createBotClient({ name }) {
+  const client = new Client({
+    intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages]
+  });
+
+  client.once("ready", () => {
+    console.log(\`[\${name}] logged in as \${client.user?.tag ?? "unknown"}\`);
+  });
+
+  return client;
+}
+`;
+}
+async function writeProjectFiles(targetDir, language) {
+    try {
+        const entries = await readdir(targetDir);
+        if (entries.length > 0) {
+            throw new Error(`Target directory is not empty: ${targetDir}. Use --dir <new-folder> to create a new project.`);
+        }
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            await mkdir(targetDir, { recursive: true });
+        }
+        else {
+            throw error;
+        }
+    }
+    await writeFile(path.join(targetDir, "package.json"), packageJsonTemplate(language), "utf8");
+    await writeFile(path.join(targetDir, language === "ts" ? "multi-discord.config.ts" : "multi-discord.config.js"), configTemplate(language), "utf8");
+    if (language === "ts") {
+        await writeFile(path.join(targetDir, "tsconfig.json"), tsconfigTemplate(), "utf8");
+    }
+    const bots = ["bot1", "bot2", "bot3"];
+    for (const bot of bots) {
+        const botSrcDir = path.join(targetDir, "bots", bot, "src");
+        await mkdir(botSrcDir, { recursive: true });
+        await writeFile(path.join(botSrcDir, `bot.${language}`), botTemplate(), "utf8");
+    }
+}
+export async function initProject(options) {
+    const invocationDir = process.env.INIT_CWD ?? process.cwd();
+    const targetDir = path.resolve(invocationDir, options.dir);
+    await writeProjectFiles(targetDir, options.language);
+    return targetDir;
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/internal-runner.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=internal-runner.d.ts.map

package/dist/internal-runner.d.ts.map

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

package/dist/internal-runner.js

@@ -0,0 +1,32 @@
+import { runBotsFromConfigFile, shutdownBots } from "./runtime.js";
+function parseConfigArg(argv) {
+    for (let i = 0; i < argv.length; i++) {
+        if ((argv[i] === "--config" || argv[i] === "-c") && argv[i + 1]) {
+            return argv[i + 1];
+        }
+    }
+    return undefined;
+}
+async function main() {
+    const configPath = parseConfigArg(process.argv.slice(2));
+    if (!configPath) {
+        throw new Error("Missing --config <file>");
+    }
+    const result = await runBotsFromConfigFile(configPath);
+    if (result.started.length === 0) {
+        process.exit(1);
+    }
+    const shutdown = async () => {
+        process.stdout.write("\n[multi-discord.js] shutting down bots...\n");
+        await shutdownBots(result.started);
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    process.stdout.write(`[multi-discord.js] running ${result.started.length} bot(s). Press Ctrl+C to stop.\n`);
+}
+main().catch((error) => {
+    process.stderr.write(`[multi-discord.js] ${String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=internal-runner.js.map

package/dist/internal-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-runner.js","sourceRoot":"","sources":["../src/internal-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEnE,SAAS,cAAc,CAAC,IAAc;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACrE,MAAM,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8BAA8B,MAAM,CAAC,OAAO,CAAC,MAAM,kCAAkC,CACtF,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,18 @@
+import { Client } from "discord.js";
+import type { MultiBotConfig } from "./types.js";
+export interface RunningBot {
+    name: string;
+    client: Client;
+}
+export interface RunBotsResult {
+    started: RunningBot[];
+    failed: Array<{
+        name: string;
+        error: unknown;
+    }>;
+}
+export declare function runBots(config: MultiBotConfig, workspaceRoot?: string): Promise<RunBotsResult>;
+export declare function shutdownBots(bots: RunningBot[]): Promise<void>;
+export declare function runBotsFromConfigFile(configPath: string): Promise<RunBotsResult>;
+export declare function resolveDefaultConfigPath(cwd?: string): Promise<string | undefined>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAKpC,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACjD;AA0HD,wBAAsB,OAAO,CAC3B,MAAM,EAAE,cAAc,EACtB,aAAa,SAAgB,GAC5B,OAAO,CAAC,aAAa,CAAC,CA0BxB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUpE;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAqBxB;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,SAAgB,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7B"}

package/dist/runtime.js

@@ -0,0 +1,143 @@
+import { Client } from "discord.js";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { DEFAULT_BOT_ENTRIES, DEFAULT_CONFIG_FILES } from "./constants.js";
+import { fileExists, resolveFrom, withDotSlash } from "./utils.js";
+async function resolveEntryFile(projectRoot, configuredEntry) {
+    if (configuredEntry) {
+        const resolved = resolveFrom(projectRoot, configuredEntry);
+        if (!(await fileExists(resolved))) {
+            throw new Error(`Configured entry file does not exist: ${resolved}`);
+        }
+        return resolved;
+    }
+    for (const candidate of DEFAULT_BOT_ENTRIES) {
+        const resolved = path.resolve(projectRoot, candidate);
+        if (await fileExists(resolved)) {
+            return resolved;
+        }
+    }
+    throw new Error(`Could not find a bot entry in ${projectRoot}. Checked: ${DEFAULT_BOT_ENTRIES.join(", ")}`);
+}
+async function loadClientFactory(entryFile) {
+    const moduleUrl = pathToFileURL(entryFile).href;
+    const imported = (await import(moduleUrl));
+    const factory = imported.createBotClient ?? imported.default;
+    if (typeof factory !== "function") {
+        throw new Error(`Bot module "${entryFile}" must export a function named "createBotClient" or a default function.`);
+    }
+    return factory;
+}
+function parseEnvLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) {
+        return undefined;
+    }
+    const match = /^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/.exec(trimmed);
+    if (!match) {
+        return undefined;
+    }
+    const key = match[1];
+    if (!key) {
+        return undefined;
+    }
+    const rawValue = match[2] ?? "";
+    const value = rawValue.replace(/^['"]|['"]$/g, "");
+    return { key, value: value.replace(/\\n/g, "\n") };
+}
+async function loadEnvFile(envFilePath) {
+    if (!(await fileExists(envFilePath))) {
+        throw new Error(`Configured env file does not exist: ${envFilePath}`);
+    }
+    const envContent = await readFile(envFilePath, "utf8");
+    for (const line of envContent.split(/\r?\n/)) {
+        const parsed = parseEnvLine(line);
+        if (!parsed) {
+            continue;
+        }
+        if (process.env[parsed.key] === undefined) {
+            process.env[parsed.key] = parsed.value;
+        }
+    }
+}
+async function startBot(project, workspaceRoot, botsBasePath) {
+    const botRoot = botsBasePath
+        ? resolveFrom(workspaceRoot, botsBasePath)
+        : workspaceRoot;
+    const projectRoot = resolveFrom(botRoot, project.path);
+    const tokenEnv = project.tokenEnv ?? `${project.name.toUpperCase()}_TOKEN`;
+    const token = process.env[tokenEnv];
+    if (!token) {
+        throw new Error(`Missing token env var "${tokenEnv}" for bot "${project.name}".`);
+    }
+    const entryFile = await resolveEntryFile(projectRoot, project.entry);
+    const factory = await loadClientFactory(entryFile);
+    const ctx = {
+        name: project.name,
+        token,
+        tokenEnv,
+        rootPath: projectRoot,
+    };
+    const client = await factory(ctx);
+    if (!(client instanceof Client)) {
+        throw new Error(`Bot "${project.name}" did not return a discord.js Client instance.`);
+    }
+    await client.login(token);
+    return { name: project.name, client };
+}
+export async function runBots(config, workspaceRoot = process.cwd()) {
+    const started = [];
+    const failed = [];
+    const mode = config.onError ?? "continue";
+    for (const project of config.bots) {
+        try {
+            const running = await startBot(project, workspaceRoot, config.botsBasePath);
+            started.push(running);
+            process.stdout.write(`[multi-discord.js] started "${project.name}"\n`);
+        }
+        catch (error) {
+            failed.push({ name: project.name, error });
+            process.stderr.write(`[multi-discord.js] failed "${project.name}": ${String(error)}\n`);
+            if (mode === "stop") {
+                break;
+            }
+        }
+    }
+    return { started, failed };
+}
+export async function shutdownBots(bots) {
+    await Promise.all(bots.map(async ({ client }) => {
+        try {
+            await client.destroy();
+        }
+        catch {
+            // Ignore per-client shutdown errors.
+        }
+    }));
+}
+export async function runBotsFromConfigFile(configPath) {
+    const absoluteConfigPath = path.resolve(process.cwd(), configPath);
+    const configModuleUrl = pathToFileURL(absoluteConfigPath).href;
+    const imported = (await import(configModuleUrl));
+    const config = imported.default;
+    if (!config || !Array.isArray(config.bots)) {
+        throw new Error(`Config file "${configPath}" must default-export { bots: [...] }`);
+    }
+    const workspaceRoot = path.dirname(absoluteConfigPath);
+    if (config.envFile) {
+        const envFilePath = resolveFrom(workspaceRoot, config.envFile);
+        await loadEnvFile(envFilePath);
+    }
+    return runBots(config, workspaceRoot);
+}
+export async function resolveDefaultConfigPath(cwd = process.cwd()) {
+    for (const filename of DEFAULT_CONFIG_FILES) {
+        const candidate = path.resolve(cwd, filename);
+        if (await fileExists(candidate)) {
+            return withDotSlash(path.relative(cwd, candidate));
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,25 @@
+import type { ClientOptions } from "discord.js";
+export interface BotProjectConfig {
+    name: string;
+    path: string;
+    entry?: string;
+    tokenEnv?: string;
+    options?: ClientOptions;
+}
+export interface MultiBotConfig {
+    bots: BotProjectConfig[];
+    envFile?: string;
+    botsBasePath?: string;
+    onError?: "continue" | "stop";
+}
+export interface CreateBotClientContext {
+    name: string;
+    token: string;
+    tokenEnv: string;
+    rootPath: string;
+}
+export interface BotClientModule {
+    createBotClient?: (ctx: CreateBotClientContext) => Promise<import("discord.js").Client> | import("discord.js").Client;
+    default?: (ctx: CreateBotClientContext) => Promise<import("discord.js").Client> | import("discord.js").Client;
+}
+//# 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,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,YAAY,EAAE,MAAM,CAAC,GAAG,OAAO,YAAY,EAAE,MAAM,CAAC;IACtH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,YAAY,EAAE,MAAM,CAAC,GAAG,OAAO,YAAY,EAAE,MAAM,CAAC;CAC/G"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# 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/dist/utils.d.ts

@@ -0,0 +1,4 @@
+export declare function fileExists(filepath: string): Promise<boolean>;
+export declare function resolveFrom(base: string, target: string): string;
+export declare function withDotSlash(input: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD"}

package/dist/utils.js

@@ -0,0 +1,21 @@
+import { access } from "node:fs/promises";
+import path from "node:path";
+export async function fileExists(filepath) {
+    try {
+        await access(filepath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function resolveFrom(base, target) {
+    return path.isAbsolute(target) ? target : path.resolve(base, target);
+}
+export function withDotSlash(input) {
+    if (input.startsWith(".") || input.startsWith("/")) {
+        return input;
+    }
+    return `./${input}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAc;IACtD,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,KAAK,EAAE,CAAC;AACtB,CAAC"}

package/package.json

@@ -1,21 +1,23 @@
 {
   "name": "multi-dc",
-  "version": "0.1.2",
+  "version": "0.1.6",
   "description": "Run multiple discord.js bots from separate folders in one Node.js process.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "multi-dc": "dist/cli.js"
+    "multi-dc": "./cli/multi-dc"
   },
   "files": [
-    "dist"
+    "dist",
+    "cli/multi-dc"
   ],
   "engines": {
     "node": ">=18.20.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "dev": "tsx src/cli.ts",
+    "build:cli": "cd cli && go build -o multi-dc",
+    "dev": "cli/multi-dc run",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "keywords": [