create-discordjs-nextgen 0.1.0

package/README.md

@@ -0,0 +1,53 @@
+# create-discordjs-nextgen
+
+CLI generator for `discordjs-nextgen`.
+
+## Usage
+
+```bash
+npx create-discordjs-nextgen my-bot
+```
+
+The CLI asks for:
+
+- Language: `JavaScript` or `TypeScript`
+- Plugins: `Voice`
+- Template: `Starter Kit`, `Basic`, `Advanced`
+
+## Templates
+
+### Basic
+
+Creates the smallest possible bot:
+
+- entry file
+- `.env`
+- `package.json`
+
+### Starter Kit
+
+Creates a practical starter project based on the examples:
+
+- `commands/prefix`
+- `commands/slash`
+- `commands/hybrid`
+- `events`
+
+### Advanced
+
+Creates a fuller example structure:
+
+- `commands`
+- `events`
+- `buttons`
+- `modals`
+- `selects`
+- `config`
+- `plugins`
+- `middleware`
+
+## Notes
+
+- `Voice` adds `discordjs-nextgen-voice`
+- TypeScript uses `src/` and adds `ts-node`, `typescript`, `@types/node`
+- Generated code follows the current `discordjs-nextgen` API

package/bin/create-discordjs-nextgen.js

@@ -0,0 +1,245 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const templatesRoot = path.resolve(__dirname, "..", "templates");
+
+async function main() {
+  console.log("");
+  p.intro(`${pc.bgBlue(pc.white(" NEXTGEN-CLI "))} ${pc.dim("Modern Discord.js Framework")}`);
+
+  const projectName = await p.text({
+    message: "Proje adını ne koyalım?",
+    placeholder: "my-nextgen-bot",
+    validate(value) {
+      if (value.length === 0) return "Lütfen bir isim girin!";
+      if (value.includes(" ")) return "Proje isminde boşluk olamaz.";
+    },
+  });
+
+  if (p.isCancel(projectName)) {
+    p.cancel("İşlem iptal edildi.");
+    process.exit(0);
+  }
+
+  const language = await p.select({
+    message: "Hangi dili tercih edersiniz?",
+    options: [
+      { value: "js", label: "JavaScript", hint: "Esnek ve hızlı" },
+      { value: "ts", label: "TypeScript", hint: "Tip güvenliği (Önerilen)" },
+    ],
+  });
+
+  if (p.isCancel(language)) {
+    p.cancel("İşlem iptal edildi.");
+    process.exit(0);
+  }
+
+  const plugins = await p.multiselect({
+    message: "Eklemek istediğiniz pluginleri seçin (Boşluk ile işaretle, Enter ile onayla):",
+    options: [
+      { value: "voice", label: "Voice Support", hint: "Müzik/Ses sistemleri için" },
+    ],
+    required: false,
+  });
+
+  if (p.isCancel(plugins)) {
+    p.cancel("İşlem iptal edildi.");
+    process.exit(0);
+  }
+
+  const template = await p.select({
+    message: "Hangi şablonla başlamak istersiniz?",
+    options: [
+      { value: "starter", label: "Starter Kit", hint: "Sadece ana dosya (Minimum)" },
+      { value: "basic", label: "Basic", hint: "Klasör yapısı & Basit komutlar" },
+      { value: "advanced", label: "Advanced", hint: "Tam teşekküllü profesyonel yapı" },
+    ],
+  });
+
+  if (p.isCancel(template)) {
+    p.cancel("İşlem iptal edildi.");
+    process.exit(0);
+  }
+
+  const s = p.spinner();
+  s.start(pc.cyan("Dosyalar hazirlaniyor..."));
+
+  const targetDir = path.resolve(process.cwd(), projectName);
+
+  try {
+    if (fs.existsSync(targetDir) && (await fsp.readdir(targetDir)).length > 0) {
+      s.stop(pc.red("Hata!"));
+      p.log.error(`Hata: '${projectName}' klasörü zaten var ve boş değil.`);
+      process.exit(1);
+    }
+
+    if (!fs.existsSync(targetDir)) {
+      await fsp.mkdir(targetDir, { recursive: true });
+    }
+
+    await generateProject(targetDir, { projectName, language, template, plugins });
+
+    s.stop(pc.green("Proje başarıyla oluşturuldu!"));
+
+    const shouldInstall = await p.confirm({
+      message: "Bağımlılıkları şimdi kurmak ister misiniz?",
+      initialValue: true,
+    });
+
+    if (shouldInstall) {
+      const installSpinner = p.spinner();
+      installSpinner.start(pc.yellow("Paketler yükleniyor..."));
+      const success = await runInstall(targetDir);
+      if (success) {
+        installSpinner.stop(pc.green("Kurulum tamamlandı!"));
+      } else {
+        installSpinner.stop(pc.red("Kurulum başarısız oldu."));
+      }
+    }
+
+    p.note(
+      `cd ${projectName}\n${!shouldInstall ? "npm install\n" : ""}npm run dev`,
+      "Sıradaki Adımlar"
+    );
+
+    p.outro(pc.blue("İyi kodlamalar! 🚀"));
+
+  } catch (err) {
+    s.stop(pc.red("Bir hata oluştu!"));
+    console.error(err);
+    process.exit(1);
+  }
+}
+
+async function generateProject(targetDir, config) {
+  const extension = config.language === "ts" ? "ts" : "js";
+  const templateDir = path.join(templatesRoot, config.template);
+
+  await copyTemplateDirectory(templateDir, targetDir, {
+    extension,
+    language: config.language,
+  });
+
+  const pkg = {
+    name: config.projectName,
+    version: "1.0.0",
+    private: true,
+    type: "module",
+    scripts: config.language === "ts" ? {
+      dev: "ts-node index.ts",
+      start: "ts-node index.ts",
+      build: "tsc"
+    } : {
+      dev: "node index.js",
+      start: "node index.js"
+    },
+    dependencies: {
+      "discordjs-nextgen": "latest",
+      "dotenv": "^17.3.1"
+    }
+  };
+
+  if (config.language === "ts") {
+    pkg.devDependencies = {
+      "@types/node": "^20.12.0",
+      "ts-node": "^10.9.2",
+      "typescript": "^5.4.5"
+    };
+    await writeFile(targetDir, "tsconfig.json", JSON.stringify({
+      compilerOptions: {
+        target: "ESNext",
+        module: "ESNext",
+        moduleResolution: "node",
+        esModuleInterop: true,
+        strict: true,
+        skipLibCheck: true,
+        outDir: "dist"
+      }
+    }, null, 2));
+  }
+
+  if (config.plugins.includes("voice")) {
+    pkg.dependencies["discordjs-nextgen-voice"] = "latest";
+  }
+
+  await writeFile(targetDir, "package.json", JSON.stringify(pkg, null, 2));
+  await writeFile(targetDir, ".gitignore", "node_modules\n.env\ndist\n");
+  await writeFile(targetDir, ".env", "TOKEN=YOUR_BOT_TOKEN_HERE");
+
+  if (config.plugins.includes("voice")) {
+    await injectVoicePlugin(targetDir, extension, config.template);
+  }
+}
+
+async function injectVoicePlugin(targetDir, extension, template) {
+  const entryPath = path.join(targetDir, `index.${extension}`);
+  let content = await fsp.readFile(entryPath, "utf8");
+
+  const importLine = `import { VoicePlugin } from "discordjs-nextgen-voice";`;
+  const useLine = `\napp.use(new VoicePlugin());`;
+
+  if (!content.includes(importLine)) {
+    content = `${importLine}\n${content}`;
+  }
+
+  if (!content.includes("new VoicePlugin()")) {
+    content = content.replace(/const app = new App\((\{[\s\S]*?\}|)\);/, (match) => `${match}\n${useLine}`);
+  }
+
+  await fsp.writeFile(entryPath, content, "utf8");
+
+  if (template !== "starter") {
+    const cmdCode = `export default {\n  name: "join",\n  description: "Sese girer.",\n  run: async (ctx) => {\n    await ctx.voice.join({ channelId: ctx.member.voice.channelId });\n  }\n};`;
+    await writeFile(targetDir, "commands/prefix/join." + extension, cmdCode);
+  }
+}
+
+async function copyTemplateDirectory(sourceDir, targetDir, context) {
+  if (!fs.existsSync(sourceDir)) return;
+  const entries = await fsp.readdir(sourceDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const src = path.join(sourceDir, entry.name);
+    const destName = entry.name.replace(/__EXT__/g, context.extension);
+    const dest = path.join(targetDir, destName);
+
+    if (entry.isDirectory()) {
+      await fsp.mkdir(dest, { recursive: true });
+      await copyTemplateDirectory(src, dest, context);
+    } else {
+      let content = await fsp.readFile(src, "utf8");
+      
+      if (context.language === "ts") {
+        content = content.replace(/\/\/ \[JS\][\s\S]*?\/\/ \[\/JS\]/g, "");
+        content = content.replace(/\/\/ \[TS\]/g, "").replace(/\/\/ \[\/TS\]/g, "");
+      } else {
+        content = content.replace(/\/\/ \[TS\][\s\S]*?\/\/ \[\/TS\]/g, "");
+        content = content.replace(/\/\/ \[JS\]/g, "").replace(/\/\/ \[\/JS\]/g, "");
+      }
+
+      content = content.replaceAll("__EXT__", context.extension);
+      await fsp.writeFile(dest, content, "utf8");
+    }
+  }
+}
+
+async function writeFile(baseDir, relPath, content) {
+  const fullPath = path.join(baseDir, relPath);
+  await fsp.mkdir(path.dirname(fullPath), { recursive: true });
+  await fsp.writeFile(fullPath, content, "utf8");
+}
+
+async function runInstall(targetDir) {
+  const result = spawnSync("npm", ["install"], { cwd: targetDir, stdio: "inherit", shell: true });
+  return result.status === 0;
+}
+
+main();

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "create-discordjs-nextgen",
+  "version": "0.1.0",
+  "description": "Scaffold a Discord bot powered by discordjs-nextgen",
+  "bin": {
+    "create-discordjs-nextgen": "./bin/create-discordjs-nextgen.js"
+  },
+  "type": "module",
+  "files": [
+    "bin",
+    "README.md",
+    "templates"
+  ],
+  "scripts": {
+    "start": "node ./bin/create-discordjs-nextgen.js",
+    "test:smoke": "node ./bin/create-discordjs-nextgen.js test-bot --yes --no-install"
+  },
+  "keywords": [
+    "discord",
+    "discordjs",
+    "discordjs-nextgen",
+    "create",
+    "cli",
+    "nextgen"
+  ],
+  "author": "Burak <@burakbehlull>",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.10.0",
+    "picocolors": "^1.1.1"
+  }
+}

package/templates/advanced/buttons/myButton.__EXT__

@@ -0,0 +1,12 @@
+// [TS]
+import type { ButtonInteraction } from 'discordjs-nextgen';
+// [/TS]
+
+const myButton = {
+  customId: 'myButton',
+  run: async (ctx // [TS]: ButtonInteraction // [/TS]) => {
+    await ctx.showModal("myModal");
+  },
+};
+
+export default myButton;

package/templates/advanced/commands/hybrid/ping.__EXT__

@@ -0,0 +1,14 @@
+// [TS]
+import { HybridCommand } from 'discordjs-nextgen';
+// [/TS]
+
+const pingHybrid // [TS]: HybridCommand // [/TS] = {
+  name: 'ping',
+  description: 'Hem prefix hem slash olarak çalışır!',
+  run: async (ctx) => {
+    const delay = Date.now() - ctx.createdAt.getTime();
+    await ctx.reply(`Pong! Gecikme: **${delay}ms**`);
+  },
+};
+
+export default pingHybrid;

package/templates/advanced/commands/prefix/colors.__EXT__

@@ -0,0 +1,23 @@
+// [TS]
+import type { PrefixCommand } from 'discordjs-nextgen';
+// [/TS]
+import { ActionRow } from 'discordjs-nextgen';
+
+const colorsCommand // [TS]: PrefixCommand // [/TS] = { 
+    name: 'colors', 
+    description: 'Color choice', 
+    run: async (ctx) => { 
+        const selectMenu = ctx.app.selects.get('mySelect'); 
+        
+        if (!selectMenu) return ctx.reply('Menü bulunamadı!'); 
+
+        const row = ActionRow.create(selectMenu); 
+
+        await ctx.reply({ 
+            content: 'Lütfen aşağıdan bir renk seç:', 
+            components: [row] 
+        }); 
+    } 
+};
+
+export default colorsCommand;

package/templates/advanced/commands/slash/hello.__EXT__

@@ -0,0 +1,15 @@
+// [TS]
+import type { SlashCommand } from 'discordjs-nextgen';
+// [/TS]
+import { SlashCommandBuilder } from 'discordjs-nextgen';
+
+const sayHello // [TS]: SlashCommand // [/TS] = {
+    data: new SlashCommandBuilder()
+        .setName('hello')
+        .setDescription('hello'),
+    run: async (ctx) => {
+        await ctx.reply("hi");
+    }
+};
+
+export default sayHello;

package/templates/advanced/events/ready.__EXT__

@@ -0,0 +1,12 @@
+// [TS]
+import type { AppEvent } from 'discordjs-nextgen';
+// [/TS]
+
+const readyEvent // [TS]: AppEvent<'ready'> // [/TS] = {
+  name: 'ready',
+  run: (user) => {
+    console.log(`${user.tag} hazır!`);
+  }
+};
+
+export default readyEvent;

package/templates/advanced/index.__EXT__

@@ -0,0 +1,50 @@
+import { App, Intents, Logger, cooldown } from 'discordjs-nextgen';
+import "dotenv/config"
+
+const app = new App({
+    intents: Intents.ALL
+});
+
+app.use(Logger({
+    colors: {
+        info: 'cyan',
+        warn: 'yellow',
+        error: 'red',
+    },
+}));
+
+app.use(cooldown(10));
+
+app
+  .events('events')
+  .prefix({
+    folder: 'commands/prefix',
+    prefix: '.',
+  })
+  .slash({
+    folder: 'commands/slash',
+  })
+  .command({
+    folder: 'commands/hybrid',
+  })
+  .button({
+    folder: 'buttons',
+  })
+  .modal({
+    folder: 'modals',
+  })
+  .select({
+    folder: 'selects',
+  });
+
+app.setPresence({
+    status: 'idle',
+    activities: [
+        {
+            name: 'Nextgen Advanced',
+            type: 0
+        },
+    ],
+});
+
+app.run(process.env.TOKEN);

package/templates/advanced/modals/myModal.__EXT__

@@ -0,0 +1,18 @@
+import { Modal } from 'discordjs-nextgen';
+
+// [TS]
+import type { ModalInteraction } from 'discordjs-nextgen';
+// [/TS]
+
+const myModal = Modal.create('myModal')
+  .title('Geri Bildirim')
+  .short('name', { label: 'Adınız', placeholder: 'Buraya yazın...' })
+  .paragraph('comment', { label: 'Yorumunuz', min: 10, max: 1000 })
+  .onSubmit(async (ctx // [TS]: ModalInteraction // [/TS]) => {
+    const name = ctx.values.name;
+    const comment = ctx.values.comment;
+    
+    await ctx.reply({ content: `Teşekkürler ${name}! Yorumun alındı.`, ephemeral: true });
+  });
+
+export default myModal;

package/templates/advanced/selects/mySelect.__EXT__

@@ -0,0 +1,19 @@
+import { Select } from 'discordjs-nextgen';
+
+// [TS]
+import type { SelectInteraction } from 'discordjs-nextgen';
+// [/TS]
+
+const mySelect = Select.create('mySelect')
+    .placeholder('Favori rengini seç...')
+    .options([
+      { label: 'Kırmızı', value: 'red', description: 'Enerjinin rengi' },
+      { label: 'Mavi', value: 'blue', description: 'Huzurun rengi' },
+      { label: 'Yeşil', value: 'green', description: 'Doğanın rengi' }
+    ])
+    .onSelect(async (ctx // [TS]: SelectInteraction // [/TS]) => {
+      const secilen = ctx.values.mySelect;
+      await ctx.reply(`Harika seçim! Demek favori rengin: **${secilen}**`);
+    });
+
+export default mySelect;

package/templates/basic/commands/hybrid/ping.__EXT__

@@ -0,0 +1,14 @@
+// [TS]
+import { HybridCommand } from 'discordjs-nextgen';
+// [/TS]
+
+const pingHybrid // [TS]: HybridCommand // [/TS] = {
+  name: 'ping',
+  description: 'Hem prefix hem slash olarak çalışır!',
+  run: async (ctx) => {
+    const delay = Date.now() - ctx.createdAt.getTime();
+    await ctx.reply(`Pong! Gecikme: **${delay}ms**`);
+  },
+};
+
+export default pingHybrid;

package/templates/basic/commands/prefix/happy.__EXT__

@@ -0,0 +1,13 @@
+// [TS]
+import type { PrefixCommand } from 'discordjs-nextgen';
+// [/TS]
+
+const happyCommand // [TS]: PrefixCommand // [/TS] = { 
+    name: 'happy', 
+    description: 'Happy emoji', 
+    run: async (ctx) => { 
+        await ctx.reply("😊");
+    } 
+};
+
+export default happyCommand;

package/templates/basic/commands/slash/hello.__EXT__

@@ -0,0 +1,15 @@
+// [TS]
+import type { SlashCommand } from 'discordjs-nextgen';
+// [/TS]
+import { SlashCommandBuilder } from 'discordjs-nextgen';
+
+const sayHello // [TS]: SlashCommand // [/TS] = {
+    data: new SlashCommandBuilder()
+        .setName('hello')
+        .setDescription('hello'),
+    run: async (ctx) => {
+        await ctx.reply("hi");
+    }
+};
+
+export default sayHello;

package/templates/basic/events/ready.__EXT__

@@ -0,0 +1,12 @@
+// [TS]
+import type { AppEvent } from 'discordjs-nextgen';
+// [/TS]
+
+const readyEvent // [TS]: AppEvent<'ready'> // [/TS] = {
+  name: 'ready',
+  run: (user) => {
+    console.log(`${user.tag} hazır!`);
+  }
+};
+
+export default readyEvent;

package/templates/basic/index.__EXT__

@@ -0,0 +1,31 @@
+import { App, Intents } from 'discordjs-nextgen';
+import "dotenv/config";
+
+const app = new App({
+    intents: Intents.ALL
+});
+
+app
+  .events('events')
+  .prefix({
+    folder: 'commands/prefix',
+    prefix: '.',
+  })
+  .slash({
+    folder: 'commands/slash',
+  })
+  .command({
+    folder: 'commands/hybrid',
+  });
+
+app.setPresence({
+    status: 'idle',
+    activities: [
+        {
+            name: 'NextGen Basic',
+            type: 0
+        },
+    ],
+});
+
+app.run(process.env.TOKEN);

package/templates/starter/index.__EXT__

@@ -0,0 +1,19 @@
+import { App, Intents } from 'discordjs-nextgen';
+import "dotenv/config";
+
+const app = new App({
+    intents: Intents.ALL
+});
+
+app.setPresence({
+    status: 'idle',
+    activities: [
+        {
+            name: 'NextGen',
+            type: 0,
+            url: null,
+        },
+    ],
+});
+
+app.run(process.env.TOKEN);