create-djskit 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,46 @@
-# Temporary Holding Version
+# create-djskit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Create a new [DJSKit](https://github.com/NZ-Linix/djskit) bot, a discord.js v14 template powered by TypeScript.
+
+```bash
+npm create djskit
+# or
+npx create-djskit my-bot
+```
+
+The walkthrough asks for the project directory, description, author, GitHub repository, bot token, message command prefix, development server ID and dev mode, then installs dependencies and initializes a git repository.
+
+## Non-interactive
+
+Pass `-y` (or run without a TTY, e.g. in CI) to skip all prompts. Anything not passed as a flag uses its default.
+
+```bash
+npx create-djskit my-bot -y --prefix "!" --dev-guild-id 123456789012345678 --repo NZ-Linix/my-bot --no-git
+```
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `[directory]` | `my-djskit-bot` | Where to create the bot. Its name is used as the package name |
+| `-y, --yes` | | Skip all prompts |
+| `-f, --force` | | Allow a non-empty directory |
+| `--description <text>` | `A discord.js bot made with DJSKit.` | package.json description |
+| `--author <name>` | git `user.name` | package.json author |
+| `--repo <owner/repo>` | | GitHub repository, adds `repository`, `bugs` and `homepage` |
+| `--token <token>` | `CLIENT_TOKEN` env var | Bot token written to `.env` |
+| `--prefix <prefix>` | `>` | Message command prefix |
+| `--dev-guild-id <id>` | | Development server ID |
+| `--[no-]dev-mode` | on | `DEV_MODE` in `.env`: register commands only to the dev server |
+| `--[no-]install` | on | Install dependencies |
+| `--[no-]git` | on | Initialize a git repository |
+
+Prefer the `CLIENT_TOKEN` environment variable over `--token`, so the token doesn't end up in your shell history.
+
+## Development
+
+```bash
+cd cli
+npm install
+npm run dev -- --help
+```
+
+`npm run build` copies the bot template from the repository root into `cli/template` and compiles the CLI to `cli/dist`.

package/dist/index.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+import { parseArgs, styleText } from "node:util";
+import * as p from "@clack/prompts";
+import { createProject, detectPackageManager, initGit, isEmptyDir, isValidGuildId, isValidPackageName, isValidPrefix, parseRepo, run, toPackageName } from "./scaffold.js";
+const { version } = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+const help = `
+${styleText("bold", "create-djskit")} v${version}: create a new DJSKit discord.js bot
+
+${styleText("bold", "Usage")}
+  npm create djskit [directory] -- [options]
+  npx create-djskit [directory] [options]
+
+${styleText("bold", "Options")}
+  -y, --yes                  Skip all prompts, use flags and defaults (also used when not in a TTY)
+  -f, --force                Allow creating the bot in a non-empty directory
+      --description <text>   package.json description
+      --author <name>        package.json author (default: git user.name)
+      --repo <owner/repo>    GitHub repository (owner/repo or URL)
+      --token <token>        Bot token, written to .env (or set the CLIENT_TOKEN env var)
+      --prefix <prefix>      Message command prefix (default: ">")
+      --dev-guild-id <id>    Development server ID
+      --[no-]dev-mode        Register commands only to the dev server (default: on)
+      --[no-]install         Install dependencies (default: on)
+      --[no-]git             Initialize a git repository (default: on)
+  -h, --help                 Show this help
+  -v, --version              Show the version
+
+${styleText("bold", "Example")}
+  npx create-djskit my-bot -y --prefix ! --dev-guild-id 123456789012345678 --repo NZ-Linix/my-bot
+`;
+// Arguments -----------------------------------------------------------------------
+const parse = () => {
+    try {
+        return parseArgs({
+            allowPositionals: true,
+            allowNegative: true,
+            options: {
+                "yes": { type: "boolean", short: "y" },
+                "force": { type: "boolean", short: "f" },
+                "description": { type: "string" },
+                "author": { type: "string" },
+                "repo": { type: "string" },
+                "token": { type: "string" },
+                "prefix": { type: "string" },
+                "dev-guild-id": { type: "string" },
+                "dev-mode": { type: "boolean" },
+                "install": { type: "boolean" },
+                "git": { type: "boolean" },
+                "help": { type: "boolean", short: "h" },
+                "version": { type: "boolean", short: "v" }
+            }
+        });
+    }
+    catch (err) {
+        return fail(err.message + "\nRun with --help to see all options.");
+    }
+};
+const fail = (message) => {
+    console.error(styleText("red", "✖ " + message));
+    process.exit(1);
+};
+const gitUserName = () => {
+    try {
+        return execSync("git config user.name", { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    }
+    catch {
+        return "";
+    }
+};
+// Prompts -------------------------------------------------------------------------
+const ask = async (prompt) => {
+    const value = await prompt;
+    if (p.isCancel(value)) {
+        p.cancel("Setup cancelled.");
+        process.exit(0);
+    }
+    return value;
+};
+const validDirectory = (force) => (value) => {
+    const dir = value?.trim() || "";
+    if (!dir)
+        return "Please enter a directory.";
+    if (!isValidPackageName(toPackageName(path.basename(path.resolve(dir)))))
+        return "Invalid project name.";
+    if (!force && !isEmptyDir(dir))
+        return `"${dir}" is not empty. Pick another directory or run with --force.`;
+};
+// Main ----------------------------------------------------------------------------
+const main = async () => {
+    const { values: flags, positionals } = parse();
+    if (flags.help)
+        return console.log(help);
+    if (flags.version)
+        return console.log(version);
+    const interactive = !flags.yes && process.stdin.isTTY && process.stdout.isTTY && !p.isCI();
+    const force = flags.force ?? false;
+    // Validate flags up front, so non-interactive runs fail before anything is written
+    const repoFlag = flags.repo ? parseRepo(flags.repo) ?? fail(`Invalid GitHub repository "${flags.repo}". Use owner/repo.`) : undefined;
+    if (flags.prefix !== undefined && !isValidPrefix(flags.prefix))
+        fail("The prefix can't be empty or contain spaces.");
+    if (flags["dev-guild-id"] !== undefined && !isValidGuildId(flags["dev-guild-id"]))
+        fail("The dev server ID must be a 17 to 20 digit number.");
+    let options;
+    let install = flags.install ?? true;
+    let git = flags.git ?? true;
+    if (interactive) {
+        p.intro(styleText(["bgGreen", "black"], " 🌿 create-djskit ") + styleText("dim", ` v${version}`));
+        let directory = positionals[0];
+        const directoryError = directory ? validDirectory(force)(directory) : undefined;
+        if (directoryError)
+            p.log.warn(directoryError);
+        if (!directory || directoryError) {
+            directory = await ask(p.text({
+                message: "Where should the bot be created?",
+                placeholder: "my-djskit-bot",
+                defaultValue: "my-djskit-bot",
+                validate: (value) => validDirectory(force)(value || "my-djskit-bot")
+            }));
+        }
+        const name = toPackageName(path.basename(path.resolve(directory)));
+        const description = flags.description ?? await ask(p.text({ message: "Description", placeholder: "A discord.js bot made with DJSKit.", defaultValue: "A discord.js bot made with DJSKit." }));
+        const author = flags.author ?? await ask(p.text({ message: "Author", placeholder: gitUserName() || "Optional", defaultValue: gitUserName() }));
+        const repo = repoFlag ?? parseRepo(await ask(p.text({
+            message: "GitHub repository",
+            placeholder: "owner/repo (optional)",
+            defaultValue: "",
+            validate: (value) => !value || parseRepo(value) ? undefined : "Use owner/repo or a github.com URL."
+        }))) ?? "";
+        const token = flags.token ?? process.env.CLIENT_TOKEN ?? await ask(p.password({ message: "Bot token (leave empty to add it to .env later)" }));
+        const prefix = flags.prefix ?? await ask(p.text({
+            message: "Message command prefix",
+            placeholder: ">",
+            defaultValue: ">",
+            validate: (value) => isValidPrefix(value || ">") ? undefined : "The prefix can't contain spaces."
+        }));
+        const devGuildId = flags["dev-guild-id"] ?? await ask(p.text({
+            message: "Development server ID",
+            placeholder: "Optional, right-click your server > Copy Server ID",
+            defaultValue: "",
+            validate: (value) => isValidGuildId(value ?? "") ? undefined : "The server ID must be a 17 to 20 digit number."
+        }));
+        const devMode = flags["dev-mode"] ?? await ask(p.confirm({
+            message: "Enable dev mode? (register commands only to the dev server)",
+            initialValue: true
+        }));
+        if (devMode && !devGuildId)
+            p.log.warn("Dev mode is on, but no dev server ID is set. Commands will be registered globally until you add devGuildId to src/config.ts.");
+        if (flags.install === undefined)
+            install = await ask(p.confirm({ message: "Install dependencies?", initialValue: true }));
+        if (flags.git === undefined)
+            git = await ask(p.confirm({ message: "Initialize a git repository?", initialValue: true }));
+        options = { directory, name, description, author, repo, token, prefix, devGuildId, devMode };
+    }
+    else {
+        const directory = positionals[0] ?? "my-djskit-bot";
+        const error = validDirectory(force)(directory);
+        if (error)
+            fail(error);
+        options = {
+            directory,
+            name: toPackageName(path.basename(path.resolve(directory))),
+            description: flags.description ?? "A discord.js bot made with DJSKit.",
+            author: flags.author ?? gitUserName(),
+            repo: repoFlag ?? "",
+            token: flags.token ?? process.env.CLIENT_TOKEN ?? "",
+            prefix: flags.prefix ?? ">",
+            devGuildId: flags["dev-guild-id"] ?? "",
+            devMode: flags["dev-mode"] ?? true
+        };
+    }
+    // Create --------------------------------------------------------------------------
+    const log = (message) => interactive ? p.log.success(message) : console.log(styleText("green", "✔ ") + message);
+    const warn = (message) => interactive ? p.log.warn(message) : console.warn(styleText("yellow", "▲ ") + message);
+    const target = createProject(options);
+    log(`Created ${options.name} in ${target}`);
+    const pm = detectPackageManager();
+    if (install) {
+        const spinner = interactive ? p.spinner() : undefined;
+        spinner?.start(`Installing dependencies with ${pm}`);
+        const ok = await run(pm, ["install"], target, interactive);
+        if (ok)
+            spinner ? spinner.stop("Installed dependencies") : log("Installed dependencies");
+        else
+            spinner ? spinner.error(`Installing failed, run "${pm} install" yourself`) : warn(`Installing failed, run "${pm} install" yourself`);
+    }
+    if (git && !await initGit(target, true))
+        warn("Could not initialize a git repository. Is git installed?");
+    // Next steps ----------------------------------------------------------------------
+    const relative = path.relative(process.cwd(), target) || ".";
+    const steps = [
+        relative !== "." && `cd ${relative}`,
+        !install && `${pm} install`,
+        !options.token && "Add your bot token to .env",
+        `${pm} start`
+    ].filter(Boolean).join("\n");
+    if (interactive) {
+        p.note(steps, "Next steps");
+        p.outro("Happy coding! 🌿");
+    }
+    else {
+        console.log("\nNext steps:\n" + steps.replace(/^/gm, "  "));
+    }
+};
+main().catch((err) => fail(err instanceof Error ? err.message : String(err)));

package/dist/scaffold.js

@@ -0,0 +1,137 @@
+import fs from "node:fs";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+const templateDir = fileURLToPath(new URL("../template", import.meta.url));
+// Validation ----------------------------------------------------------------------
+export const toPackageName = (input) => input.trim().toLowerCase().replace(/\s+/g, "-").replace(/^[._]+/, "").replace(/[^a-z0-9-~._]+/g, "-");
+export const isValidPackageName = (name) => /^[a-z0-9-~][a-z0-9-._~]*$/.test(name) && name.length <= 214;
+export const isValidGuildId = (id) => id === "" || /^\d{17,20}$/.test(id);
+export const isValidPrefix = (prefix) => prefix.length > 0 && !/\s/.test(prefix);
+// Accepts "owner/repo", "https://github.com/owner/repo(.git)" and "git@github.com:owner/repo.git"
+export const parseRepo = (input) => {
+    const match = input.trim().match(/^(?:https?:\/\/github\.com\/|git@github\.com:)?([\w.-]+)\/([\w.-]+?)(?:\.git)?\/?$/);
+    return match ? `${match[1]}/${match[2]}` : null;
+};
+export const isEmptyDir = (dir) => !fs.existsSync(dir) || fs.readdirSync(dir).every((file) => file === ".git" || file === ".DS_Store");
+// Scaffolding ---------------------------------------------------------------------
+export const createProject = (options) => {
+    const target = path.resolve(options.directory);
+    fs.mkdirSync(target, { recursive: true });
+    fs.cpSync(templateDir, target, {
+        recursive: true,
+        filter: (source) => path.basename(source) !== "_package.json"
+    });
+    fs.renameSync(path.join(target, "gitignore"), path.join(target, ".gitignore"));
+    writeConfig(target, options);
+    writeEnv(target, options);
+    writePackageJson(target, options);
+    fs.writeFileSync(path.join(target, "README.md"), readme(options));
+    return target;
+};
+const writeConfig = (target, options) => {
+    const file = path.join(target, "src", "config.ts");
+    let config = fs.readFileSync(file, "utf8");
+    for (const [key, value] of [["devGuildId", options.devGuildId], ["messageCommandPrefix", options.prefix]]) {
+        const pattern = new RegExp(`(${key}:\\s*)"[^"]*"`);
+        if (!pattern.test(config))
+            throw new Error(`Could not find "${key}" in src/config.ts of the template.`);
+        config = config.replace(pattern, (_, start) => start + JSON.stringify(value));
+    }
+    fs.writeFileSync(file, config);
+};
+const writeEnv = (target, options) => {
+    const env = [
+        `CLIENT_TOKEN = "${options.token || "[ YOUR CLIENT TOKEN HERE ]"}"`,
+        "",
+        "# true = register commands only to the dev server (devGuildId in src/config.ts), false = register globally",
+        `DEV_MODE = ${options.devMode}`,
+        ""
+    ].join("\n");
+    fs.writeFileSync(path.join(target, ".env"), env, { mode: 0o600 });
+};
+const writePackageJson = (target, options) => {
+    const base = JSON.parse(fs.readFileSync(path.join(templateDir, "_package.json"), "utf8"));
+    const repo = options.repo;
+    const pkg = {
+        name: options.name,
+        version: "1.0.0",
+        description: options.description,
+        private: true,
+        author: options.author || undefined,
+        homepage: repo ? `https://github.com/${repo}#readme` : undefined,
+        bugs: repo ? { url: `https://github.com/${repo}/issues` } : undefined,
+        repository: repo ? { type: "git", url: `git+https://github.com/${repo}.git` } : undefined,
+        type: base.type,
+        main: base.main,
+        engines: { node: ">=22" },
+        scripts: { ...base.scripts, typecheck: "tsc" },
+        dependencies: base.dependencies,
+        devDependencies: base.devDependencies
+    };
+    fs.writeFileSync(path.join(target, "package.json"), JSON.stringify(pkg, null, 2) + "\n");
+};
+const readme = (options) => `# ${options.name}
+
+${options.description}
+${options.repo ? `\n**Repository:** https://github.com/${options.repo}\n` : ""}
+Made with [DJSKit](https://github.com/NZ-Linix/djskit), a discord.js v14 bot template powered by TypeScript.
+
+## Getting started
+
+Requires Node.js 22 or newer.
+
+\`\`\`bash
+npm install
+npm start
+\`\`\`
+
+## Configuration
+
+- \`.env\`: \`CLIENT_TOKEN\` is your bot token, \`DEV_MODE\` controls where commands are registered (see below). Never commit this file.
+- \`src/config.ts\`: \`devGuildId\` (your development server), \`messageCommandPrefix\` (currently \`${options.prefix}\`) and status rotations.
+
+### Dev mode
+
+| \`DEV_MODE\` | Commands are registered to | Message commands respond in |
+| --- | --- | --- |
+| \`true\` | Only the dev server (\`devGuildId\`) | Only the dev server |
+| \`false\` | Every server (global) | Every server |
+
+Dev server commands update instantly, which makes testing much faster. If \`DEV_MODE\` is \`true\` but no \`devGuildId\` is set, commands are registered globally.
+
+## Project structure
+
+| Folder | Contents |
+| --- | --- |
+| \`src/commands/\` | Slash commands (\`SlashCommandBuilder\`, with optional \`autocomplete\`) and prefix message commands |
+| \`src/context/Message/\` | Message context menu commands (right-click a message > Apps) |
+| \`src/context/User/\` | User context menu commands (right-click a user > Apps) |
+| \`src/components/\` | Button, select menu and modal handlers |
+| \`src/events/\` | Discord event listeners |
+`;
+// Post setup ----------------------------------------------------------------------
+export const detectPackageManager = () => {
+    const agent = process.env.npm_config_user_agent ?? "";
+    for (const pm of ["pnpm", "yarn", "bun"]) {
+        if (agent.startsWith(pm))
+            return pm;
+    }
+    return "npm";
+};
+export const run = (command, args, cwd, quiet) => new Promise((resolve) => {
+    const child = spawn(command, args, {
+        cwd,
+        stdio: quiet ? "ignore" : "inherit",
+        shell: process.platform === "win32"
+    });
+    child.on("error", () => resolve(false));
+    child.on("close", (code) => resolve(code === 0));
+});
+export const initGit = async (target, quiet) => {
+    if (!await run("git", ["init", "-q"], target, quiet))
+        return false;
+    await run("git", ["add", "-A"], target, quiet);
+    await run("git", ["commit", "-q", "-m", "Initial commit from create-djskit"], target, quiet);
+    return true;
+};

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "create-djskit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Create a new DJSKit discord.js bot in seconds.",
+  "keywords": [
+    "discord",
+    "discord.js",
+    "bot",
+    "template",
+    "typescript",
+    "create",
+    "cli"
+  ],
+  "homepage": "https://github.com/NZ-Linix/djskit#readme",
+  "bugs": {
+    "url": "https://github.com/NZ-Linix/djskit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NZ-Linix/djskit.git",
+    "directory": "cli"
+  },
+  "license": "MIT",
+  "author": "NZ-Linix",
+  "type": "module",
+  "bin": {
+    "create-djskit": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "node scripts/sync-template.mjs && tsc",
+    "prepack": "npm run build",
+    "dev": "npm run build && node dist/index.js"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.8.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.19.2",
+    "typescript": "^7.0.2"
+  }
+}

package/template/.env.example

@@ -0,0 +1,4 @@
+CLIENT_TOKEN = "[ YOUR CLIENT TOKEN HERE ]"
+
+# true = register commands only to the dev server (devGuildId in src/config.ts), false = register globally
+DEV_MODE = false

package/template/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/template/_package.json

@@ -0,0 +1,32 @@
+{
+  "name": "djskit",
+  "version": "1.0.0",
+  "description": "Discord.js Kit: TypeScript discord bot handler.",
+  "keywords": [],
+  "homepage": "https://github.com/NZ-Linix/djskit#readme",
+  "bugs": {
+    "url": "https://github.com/NZ-Linix/djskit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NZ-Linix/djskit.git"
+  },
+  "license": "MIT",
+  "author": "NZ-Linix",
+  "type": "commonjs",
+  "main": "src/index.ts",
+  "scripts": {
+    "start": "tsx ."
+  },
+  "devDependencies": {
+    "@types/node": "^24.19.2",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2"
+  },
+  "dependencies": {
+    "chalk": "^6.0.1",
+    "discord.js": "^14.27.0",
+    "dotdatabase": "^1.1.6",
+    "dotenv": "^18.0.9"
+  }
+}

package/template/gitignore

@@ -0,0 +1,5 @@
+/node_modules
+/src/database/*
+
+package-lock.json
+.env

package/template/src/commands/TestMessage/test-dollar.ts

@@ -0,0 +1,17 @@
+import { Message, Client } from "discord.js";
+
+export default {
+
+    data: {
+        name: "test",
+        description: "Test command with $ prefix",
+        customPrefix: "$"
+    },
+
+    async execute( message: Message, client: Client, args: string[] ) {
+
+        await message.reply({ content: "Test command executed with $ prefix!" });
+
+    }
+
+}

package/template/src/commands/TestMessage/test.ts

@@ -0,0 +1,16 @@
+import { Message, Client } from "discord.js";
+
+export default {
+
+    data: {
+        name: "test",
+        description: "Test command",
+    },
+
+    async execute( message: Message, client: Client, args: string[] ) {
+
+        await message.reply({ content: "Test command executed!" });
+
+    }
+
+}

package/template/src/commands/TestSlash/autocomplete.ts

@@ -0,0 +1,60 @@
+import { AutocompleteInteraction, ChatInputCommandInteraction, Client, SlashCommandBuilder } from "discord.js";
+
+const fruits: Record<string, string[]> = {
+    Apple: ["Fuji", "Gala", "Granny Smith", "Honeycrisp"],
+    Grape: ["Concord", "Cotton Candy", "Thompson Seedless"],
+    Mango: ["Alphonso", "Ataulfo", "Kent"],
+    Orange: ["Blood Orange", "Navel", "Valencia"],
+    Pear: ["Bartlett", "Bosc", "Conference"]
+};
+
+export default {
+
+    data: new SlashCommandBuilder()
+    .setName("testautocomplete")
+    .setDescription("Test command with autocomplete")
+    .addStringOption((option) => option
+        .setName("fruit")
+        .setDescription("Pick a fruit")
+        .setRequired(true)
+        .setAutocomplete(true)
+    )
+    .addStringOption((option) => option
+        .setName("variety")
+        .setDescription("Pick a variety of the fruit")
+        .setRequired(true)
+        .setAutocomplete(true)
+    ),
+
+    async autocomplete( interaction: AutocompleteInteraction, client: Client ) {
+
+        const focused = interaction.options.getFocused(true);
+        const value = focused.value.toLowerCase();
+
+        let choices: string[] = [];
+
+        if ( focused.name === "fruit" ) {
+            choices = Object.keys(fruits);
+        }
+
+        if ( focused.name === "variety" ) {
+            const fruit = interaction.options.getString("fruit");
+            choices = fruit && fruits[fruit] ? fruits[fruit] : Object.values(fruits).flat();
+        }
+
+        choices = choices.filter((choice) => choice.toLowerCase().includes(value)).slice(0, 25);
+
+        await interaction.respond(choices.map((choice) => ({ name: choice, value: choice })));
+
+    },
+
+    async execute( interaction: ChatInputCommandInteraction, client: Client ) {
+
+        const fruit = interaction.options.getString("fruit", true);
+        const variety = interaction.options.getString("variety", true);
+
+        await interaction.reply({ content: "You picked: " + variety + " (" + fruit + ")" });
+
+    }
+
+}

package/template/src/commands/TestSlash/button.ts

@@ -0,0 +1,22 @@
+import { ChatInputCommandInteraction, Client, SlashCommandBuilder, ActionRowBuilder, ButtonBuilder, ButtonStyle, MessageFlags } from "discord.js";
+
+export default {
+    data: new SlashCommandBuilder()
+        .setName("testbutton")
+        .setDescription("Sends a test button"),
+
+    async execute(interaction: ChatInputCommandInteraction, client: Client) {
+        const row = new ActionRowBuilder<ButtonBuilder>().addComponents(
+            new ButtonBuilder()
+                .setCustomId("test_button:name=" + interaction.user.displayName)
+                .setLabel("Test Button")
+                .setStyle(ButtonStyle.Primary)
+        );
+
+        await interaction.reply({
+            content: "Click the button below!",
+            components: [row],
+            flags: [MessageFlags.Ephemeral]
+        });
+    }
+};

package/template/src/commands/TestSlash/test.ts

@@ -0,0 +1,15 @@
+import { ChatInputCommandInteraction, Client, SlashCommandBuilder } from "discord.js";
+
+export default {
+
+    data: new SlashCommandBuilder()
+    .setName("test")
+    .setDescription("Test command"),
+
+    async execute( interaction: ChatInputCommandInteraction, client: Client ) {
+
+        await interaction.reply({ content: "Test command executed!" });
+
+    }
+
+}

package/template/src/components/buttons/testButton.ts

@@ -0,0 +1,11 @@
+import { ButtonInteraction, Client, MessageFlags } from "discord.js";
+
+export default {
+
+    customId: "test_button",
+
+    async execute(interaction: ButtonInteraction, client: Client, args: Record<string, string>) {
+        await interaction.reply({ content: "Test button clicked! Name: " + args.name, flags: [MessageFlags.Ephemeral] });
+    },
+
+};

package/template/src/config.ts

@@ -0,0 +1,10 @@
+export default {
+
+    devGuildId: "",
+    messageCommandPrefix: ">",
+
+    status: {
+        rotations: [],
+    }
+
+}