seyfert-bot-starter 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Razi
+
+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,120 @@
+<div align="center">
+
+# seyfert-bot-starter
+
+```
+  create-seyfert-bot my-bot
+        |
+        v
+  [ src/index.ts ]  [ src/commands/ ]  [ .env ]  [ biome ]
+        |                  |               |          |
+        +----- Seyfert 5 ----+------ dotenv -----+----+
+```
+
+**A total starter for a modern Seyfert Discord bot. One command, zero config.**
+
+</div>
+
+<div align="center">
+
+[![npm](https://img.shields.io/npm/v/seyfert-bot-starter?style=flat-square&color=b873fa&logo=npm&label=npm)](https://www.npmjs.com/package/seyfert-bot-starter)
+[![downloads](https://img.shields.io/npm/dm/seyfert-bot-starter?style=flat-square&color=9a3ff0)](https://www.npmjs.com/package/seyfert-bot-starter)
+[![license](https://img.shields.io/github/license/knownasrazi/seyfert-bot-starter?style=flat-square&color=7c26e0)](LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/knownasrazi/seyfert-bot-starter/ci.yml?style=flat-square&label=CI)](https://github.com/knownasrazi/seyfert-bot-starter/actions)
+[![bun](https://img.shields.io/badge/runtime-bun-7c26e0?style=flat-square&logo=bun&logoColor=white)](https://bun.sh)
+
+</div>
+
+---
+
+## get the bot running
+
+```bash
+bunx create-seyfert-bot my-bot
+cd my-bot
+
+cp .env.example .env     # add your BOT_TOKEN
+bun install
+bun run dev
+```
+
+Your bot is ready. That's the whole onboarding.
+
+## what you get
+
+```
+my-bot
+|-- package.json        # seyfert 5, dotenvx, bun scripts
+|-- tsconfig.json       # strict, decorator-ready
+|-- biome.json          # formatting + linting
+|-- .env.example        # BOT_TOKEN / CLIENT_ID
+|-- src
+|   |-- index.ts        # client bootstrap, ready event
+|   `-- commands
+|       `-- ping.ts     # first slash command
+`-- README.md           # scaffolded with your name
+```
+
+## the parts
+
+| part | duty |
+| ---- | ---- |
+| `src/index.ts` | builds the client, sets intents + locations, logs in |
+| `src/commands/` | every file here is auto-registered on startup |
+| `@dotenvx/dotenvx` | loads `.env` before the client boots |
+| `biome.json` | shared lint + format rules, spaces/2 |
+| scripts | `dev`/`start`/`lint`/`typecheck`/`format` |
+
+## why this over hand-typing
+
+| issue | starter |
+| ----- | ------- |
+| decorator tsconfig flags missing | already enabled |
+| `.env` never loaded | dotenvx imported up top |
+| commands need the right `locations` | wired in `index.ts` |
+| lint/deps drift | pinned `biome.json` + versions |
+
+## add a command
+
+```ts
+// src/commands/hello.ts
+import { Command, type CommandContext, Declare } from "seyfert";
+
+@Declare({
+  name: "hello",
+  description: "Wave back",
+})
+export default class HelloCommand extends Command {
+  run(ctx: CommandContext) {
+    return ctx.write({ content: "Hello there!" });
+  }
+}
+```
+
+Restart `bun run dev` and it registers itself.
+
+## install instead of scaffold?
+
+`create-seyfert-bot` copies the template. If you want the template as a
+reference tree instead, read `src/template/` in the repo.
+
+## development of this package
+
+```bash
+git clone https://github.com/knownasrazi/seyfert-bot-starter.git
+cd seyfert-bot-starter
+bun install
+bun run release
+```
+
+## license
+
+[MIT](./LICENSE) + [Razi](https://github.com/knownasrazi)
+
+---
+
+<div align="center">
+
+*one command in. one bot working.*
+
+</div>

package/dist/chunk-H36REW25.js

@@ -0,0 +1,37 @@
+import { mkdir, readdir, readFile, writeFile } from 'fs/promises';
+import { join, dirname, resolve, basename } from 'path';
+import { fileURLToPath } from 'url';
+
+// src/scaffold.ts
+var PROJECT_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
+var TEMPLATE_DIR = join(PROJECT_ROOT, "template");
+var VARIABLES = {
+  "<PACKAGE_NAME>": (targetDir) => basename(targetDir)
+};
+async function scaffold(targetDir) {
+  const target = resolve(targetDir);
+  await mkdir(target, { recursive: true });
+  await copyTree(TEMPLATE_DIR, target);
+  return target;
+}
+async function copyTree(from, to) {
+  const entries = await readdir(from, { withFileTypes: true });
+  for (const entry of entries) {
+    const src = join(from, entry.name);
+    const dest = join(to, entry.name);
+    if (entry.isDirectory()) {
+      await mkdir(dest, { recursive: true });
+      await copyTree(src, dest);
+    } else {
+      let data = await readFile(src, "utf8");
+      for (const [token, resolve2] of Object.entries(VARIABLES)) {
+        data = data.replaceAll(token, resolve2(to));
+      }
+      await writeFile(dest, data, "utf8");
+    }
+  }
+}
+
+export { TEMPLATE_DIR, scaffold };
+//# sourceMappingURL=chunk-H36REW25.js.map
+//# sourceMappingURL=chunk-H36REW25.js.map

package/dist/chunk-H36REW25.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scaffold.ts"],"names":["resolve"],"mappings":";;;;;AAIA,IAAM,YAAA,GAAe,KAAK,OAAA,CAAQ,aAAA,CAAc,YAAY,GAAG,CAAC,GAAG,IAAI,CAAA;AAEhE,IAAM,YAAA,GAAe,IAAA,CAAK,YAAA,EAAc,UAAU;AAEzD,IAAM,SAAA,GAA2D;AAAA,EAC/D,gBAAA,EAAkB,CAAC,SAAA,KAAc,QAAA,CAAS,SAAS;AACrD,CAAA;AAEA,eAAsB,SAAS,SAAA,EAAoC;AACjE,EAAA,MAAM,MAAA,GAAS,QAAQ,SAAS,CAAA;AAChC,EAAA,MAAM,KAAA,CAAM,MAAA,EAAQ,EAAE,SAAA,EAAW,MAAM,CAAA;AACvC,EAAA,MAAM,QAAA,CAAS,cAAc,MAAM,CAAA;AACnC,EAAA,OAAO,MAAA;AACT;AAEA,eAAe,QAAA,CAAS,MAAc,EAAA,EAA2B;AAC/D,EAAA,MAAM,UAAU,MAAM,OAAA,CAAQ,MAAM,EAAE,aAAA,EAAe,MAAM,CAAA;AAC3D,EAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,IAAA,EAAM,KAAA,CAAM,IAAI,CAAA;AACjC,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,EAAA,EAAI,KAAA,CAAM,IAAI,CAAA;AAChC,IAAA,IAAI,KAAA,CAAM,aAAY,EAAG;AACvB,MAAA,MAAM,KAAA,CAAM,IAAA,EAAM,EAAE,SAAA,EAAW,MAAM,CAAA;AACrC,MAAA,MAAM,QAAA,CAAS,KAAK,IAAI,CAAA;AAAA,IAC1B,CAAA,MAAO;AACL,MAAA,IAAI,IAAA,GAAO,MAAM,QAAA,CAAS,GAAA,EAAK,MAAM,CAAA;AACrC,MAAA,KAAA,MAAW,CAAC,KAAA,EAAOA,QAAO,KAAK,MAAA,CAAO,OAAA,CAAQ,SAAS,CAAA,EAAG;AACxD,QAAA,IAAA,GAAO,IAAA,CAAK,UAAA,CAAW,KAAA,EAAOA,QAAAA,CAAQ,EAAE,CAAC,CAAA;AAAA,MAC3C;AACA,MAAA,MAAM,SAAA,CAAU,IAAA,EAAM,IAAA,EAAM,MAAM,CAAA;AAAA,IACpC;AAAA,EACF;AACF","file":"chunk-H36REW25.js","sourcesContent":["import { mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PROJECT_ROOT = join(dirname(fileURLToPath(import.meta.url)), \"..\");\n\nexport const TEMPLATE_DIR = join(PROJECT_ROOT, \"template\");\n\nconst VARIABLES: Record<string, (targetDir: string) => string> = {\n  \"<PACKAGE_NAME>\": (targetDir) => basename(targetDir),\n};\n\nexport async function scaffold(targetDir: string): Promise<string> {\n  const target = resolve(targetDir);\n  await mkdir(target, { recursive: true });\n  await copyTree(TEMPLATE_DIR, target);\n  return target;\n}\n\nasync function copyTree(from: string, to: string): Promise<void> {\n  const entries = await readdir(from, { withFileTypes: true });\n  for (const entry of entries) {\n    const src = join(from, entry.name);\n    const dest = join(to, entry.name);\n    if (entry.isDirectory()) {\n      await mkdir(dest, { recursive: true });\n      await copyTree(src, dest);\n    } else {\n      let data = await readFile(src, \"utf8\");\n      for (const [token, resolve] of Object.entries(VARIABLES)) {\n        data = data.replaceAll(token, resolve(to));\n      }\n      await writeFile(dest, data, \"utf8\");\n    }\n  }\n}\n"]}

package/dist/cli.cjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env bun
+'use strict';
+
+var promises = require('fs/promises');
+var path = require('path');
+var url = require('url');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+var PROJECT_ROOT = path.join(path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.cjs', document.baseURI).href)))), "..");
+var TEMPLATE_DIR = path.join(PROJECT_ROOT, "template");
+var VARIABLES = {
+  "<PACKAGE_NAME>": (targetDir) => path.basename(targetDir)
+};
+async function scaffold(targetDir) {
+  const target = path.resolve(targetDir);
+  await promises.mkdir(target, { recursive: true });
+  await copyTree(TEMPLATE_DIR, target);
+  return target;
+}
+async function copyTree(from, to) {
+  const entries = await promises.readdir(from, { withFileTypes: true });
+  for (const entry of entries) {
+    const src = path.join(from, entry.name);
+    const dest = path.join(to, entry.name);
+    if (entry.isDirectory()) {
+      await promises.mkdir(dest, { recursive: true });
+      await copyTree(src, dest);
+    } else {
+      let data = await promises.readFile(src, "utf8");
+      for (const [token, resolve2] of Object.entries(VARIABLES)) {
+        data = data.replaceAll(token, resolve2(to));
+      }
+      await promises.writeFile(dest, data, "utf8");
+    }
+  }
+}
+
+// src/cli.ts
+var name = process.argv[2] ?? "";
+if (name === "") {
+  console.error("usage: create-seyfert-bot <project-name>");
+  process.exit(1);
+}
+if (name.includes(" ")) {
+  console.error("error: project name must be a single word");
+  process.exit(1);
+}
+async function main() {
+  const target = await scaffold(name);
+  console.log(`scaffolded a seyfert bot at ${target}`);
+  console.log("next:");
+  console.log(`  cd ${name}`);
+  console.log("  bun install");
+  console.log("  cp .env.example .env  # add your BOT_TOKEN");
+  console.log("  bun run dev");
+}
+void main();
+//# sourceMappingURL=cli.cjs.map
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scaffold.ts","../src/cli.ts"],"names":["join","dirname","fileURLToPath","basename","resolve","mkdir","readdir","readFile","writeFile"],"mappings":";;;;;;;;AAIA,IAAM,YAAA,GAAeA,UAAKC,YAAA,CAAQC,iBAAA,CAAc,yPAAe,CAAC,GAAG,IAAI,CAAA;AAEhE,IAAM,YAAA,GAAeF,SAAA,CAAK,YAAA,EAAc,UAAU,CAAA;AAEzD,IAAM,SAAA,GAA2D;AAAA,EAC/D,gBAAA,EAAkB,CAAC,SAAA,KAAcG,aAAA,CAAS,SAAS;AACrD,CAAA;AAEA,eAAsB,SAAS,SAAA,EAAoC;AACjE,EAAA,MAAM,MAAA,GAASC,aAAQ,SAAS,CAAA;AAChC,EAAA,MAAMC,cAAA,CAAM,MAAA,EAAQ,EAAE,SAAA,EAAW,MAAM,CAAA;AACvC,EAAA,MAAM,QAAA,CAAS,cAAc,MAAM,CAAA;AACnC,EAAA,OAAO,MAAA;AACT;AAEA,eAAe,QAAA,CAAS,MAAc,EAAA,EAA2B;AAC/D,EAAA,MAAM,UAAU,MAAMC,gBAAA,CAAQ,MAAM,EAAE,aAAA,EAAe,MAAM,CAAA;AAC3D,EAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,IAAA,MAAM,GAAA,GAAMN,SAAA,CAAK,IAAA,EAAM,KAAA,CAAM,IAAI,CAAA;AACjC,IAAA,MAAM,IAAA,GAAOA,SAAA,CAAK,EAAA,EAAI,KAAA,CAAM,IAAI,CAAA;AAChC,IAAA,IAAI,KAAA,CAAM,aAAY,EAAG;AACvB,MAAA,MAAMK,cAAA,CAAM,IAAA,EAAM,EAAE,SAAA,EAAW,MAAM,CAAA;AACrC,MAAA,MAAM,QAAA,CAAS,KAAK,IAAI,CAAA;AAAA,IAC1B,CAAA,MAAO;AACL,MAAA,IAAI,IAAA,GAAO,MAAME,iBAAA,CAAS,GAAA,EAAK,MAAM,CAAA;AACrC,MAAA,KAAA,MAAW,CAAC,KAAA,EAAOH,QAAO,KAAK,MAAA,CAAO,OAAA,CAAQ,SAAS,CAAA,EAAG;AACxD,QAAA,IAAA,GAAO,IAAA,CAAK,UAAA,CAAW,KAAA,EAAOA,QAAAA,CAAQ,EAAE,CAAC,CAAA;AAAA,MAC3C;AACA,MAAA,MAAMI,kBAAA,CAAU,IAAA,EAAM,IAAA,EAAM,MAAM,CAAA;AAAA,IACpC;AAAA,EACF;AACF;;;AChCA,IAAM,IAAA,GAAO,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,IAAK,EAAA;AAEhC,IAAI,SAAS,EAAA,EAAI;AACf,EAAA,OAAA,CAAQ,MAAM,0CAA0C,CAAA;AACxD,EAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAChB;AACA,IAAI,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,EAAG;AACtB,EAAA,OAAA,CAAQ,MAAM,2CAA2C,CAAA;AACzD,EAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAChB;AAEA,eAAe,IAAA,GAAsB;AACnC,EAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,IAAI,CAAA;AAClC,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,4BAAA,EAA+B,MAAM,CAAA,CAAE,CAAA;AACnD,EAAA,OAAA,CAAQ,IAAI,OAAO,CAAA;AACnB,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,KAAA,EAAQ,IAAI,CAAA,CAAE,CAAA;AAC1B,EAAA,OAAA,CAAQ,IAAI,eAAe,CAAA;AAC3B,EAAA,OAAA,CAAQ,IAAI,8CAA8C,CAAA;AAC1D,EAAA,OAAA,CAAQ,IAAI,eAAe,CAAA;AAC7B;AAEA,KAAK,IAAA,EAAK","file":"cli.cjs","sourcesContent":["import { mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PROJECT_ROOT = join(dirname(fileURLToPath(import.meta.url)), \"..\");\n\nexport const TEMPLATE_DIR = join(PROJECT_ROOT, \"template\");\n\nconst VARIABLES: Record<string, (targetDir: string) => string> = {\n  \"<PACKAGE_NAME>\": (targetDir) => basename(targetDir),\n};\n\nexport async function scaffold(targetDir: string): Promise<string> {\n  const target = resolve(targetDir);\n  await mkdir(target, { recursive: true });\n  await copyTree(TEMPLATE_DIR, target);\n  return target;\n}\n\nasync function copyTree(from: string, to: string): Promise<void> {\n  const entries = await readdir(from, { withFileTypes: true });\n  for (const entry of entries) {\n    const src = join(from, entry.name);\n    const dest = join(to, entry.name);\n    if (entry.isDirectory()) {\n      await mkdir(dest, { recursive: true });\n      await copyTree(src, dest);\n    } else {\n      let data = await readFile(src, \"utf8\");\n      for (const [token, resolve] of Object.entries(VARIABLES)) {\n        data = data.replaceAll(token, resolve(to));\n      }\n      await writeFile(dest, data, \"utf8\");\n    }\n  }\n}\n","#!/usr/bin/env bun\nimport { scaffold } from \"./scaffold.js\";\n\nconst name = process.argv[2] ?? \"\";\n\nif (name === \"\") {\n  console.error(\"usage: create-seyfert-bot <project-name>\");\n  process.exit(1);\n}\nif (name.includes(\" \")) {\n  console.error(\"error: project name must be a single word\");\n  process.exit(1);\n}\n\nasync function main(): Promise<void> {\n  const target = await scaffold(name);\n  console.log(`scaffolded a seyfert bot at ${target}`);\n  console.log(\"next:\");\n  console.log(`  cd ${name}`);\n  console.log(\"  bun install\");\n  console.log(\"  cp .env.example .env  # add your BOT_TOKEN\");\n  console.log(\"  bun run dev\");\n}\n\nvoid main();\n"]}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env bun

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env bun

package/dist/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env bun
+import { scaffold } from './chunk-H36REW25.js';
+
+// src/cli.ts
+var name = process.argv[2] ?? "";
+if (name === "") {
+  console.error("usage: create-seyfert-bot <project-name>");
+  process.exit(1);
+}
+if (name.includes(" ")) {
+  console.error("error: project name must be a single word");
+  process.exit(1);
+}
+async function main() {
+  const target = await scaffold(name);
+  console.log(`scaffolded a seyfert bot at ${target}`);
+  console.log("next:");
+  console.log(`  cd ${name}`);
+  console.log("  bun install");
+  console.log("  cp .env.example .env  # add your BOT_TOKEN");
+  console.log("  bun run dev");
+}
+void main();
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"names":[],"mappings":";;;;AAGA,IAAM,IAAA,GAAO,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,IAAK,EAAA;AAEhC,IAAI,SAAS,EAAA,EAAI;AACf,EAAA,OAAA,CAAQ,MAAM,0CAA0C,CAAA;AACxD,EAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAChB;AACA,IAAI,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,EAAG;AACtB,EAAA,OAAA,CAAQ,MAAM,2CAA2C,CAAA;AACzD,EAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAChB;AAEA,eAAe,IAAA,GAAsB;AACnC,EAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,IAAI,CAAA;AAClC,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,4BAAA,EAA+B,MAAM,CAAA,CAAE,CAAA;AACnD,EAAA,OAAA,CAAQ,IAAI,OAAO,CAAA;AACnB,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,KAAA,EAAQ,IAAI,CAAA,CAAE,CAAA;AAC1B,EAAA,OAAA,CAAQ,IAAI,eAAe,CAAA;AAC3B,EAAA,OAAA,CAAQ,IAAI,8CAA8C,CAAA;AAC1D,EAAA,OAAA,CAAQ,IAAI,eAAe,CAAA;AAC7B;AAEA,KAAK,IAAA,EAAK","file":"cli.js","sourcesContent":["#!/usr/bin/env bun\nimport { scaffold } from \"./scaffold.js\";\n\nconst name = process.argv[2] ?? \"\";\n\nif (name === \"\") {\n  console.error(\"usage: create-seyfert-bot <project-name>\");\n  process.exit(1);\n}\nif (name.includes(\" \")) {\n  console.error(\"error: project name must be a single word\");\n  process.exit(1);\n}\n\nasync function main(): Promise<void> {\n  const target = await scaffold(name);\n  console.log(`scaffolded a seyfert bot at ${target}`);\n  console.log(\"next:\");\n  console.log(`  cd ${name}`);\n  console.log(\"  bun install\");\n  console.log(\"  cp .env.example .env  # add your BOT_TOKEN\");\n  console.log(\"  bun run dev\");\n}\n\nvoid main();\n"]}

package/dist/index.cjs

@@ -0,0 +1,41 @@
+'use strict';
+
+var promises = require('fs/promises');
+var path = require('path');
+var url = require('url');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+// src/scaffold.ts
+var PROJECT_ROOT = path.join(path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))), "..");
+var TEMPLATE_DIR = path.join(PROJECT_ROOT, "template");
+var VARIABLES = {
+  "<PACKAGE_NAME>": (targetDir) => path.basename(targetDir)
+};
+async function scaffold(targetDir) {
+  const target = path.resolve(targetDir);
+  await promises.mkdir(target, { recursive: true });
+  await copyTree(TEMPLATE_DIR, target);
+  return target;
+}
+async function copyTree(from, to) {
+  const entries = await promises.readdir(from, { withFileTypes: true });
+  for (const entry of entries) {
+    const src = path.join(from, entry.name);
+    const dest = path.join(to, entry.name);
+    if (entry.isDirectory()) {
+      await promises.mkdir(dest, { recursive: true });
+      await copyTree(src, dest);
+    } else {
+      let data = await promises.readFile(src, "utf8");
+      for (const [token, resolve2] of Object.entries(VARIABLES)) {
+        data = data.replaceAll(token, resolve2(to));
+      }
+      await promises.writeFile(dest, data, "utf8");
+    }
+  }
+}
+
+exports.TEMPLATE_DIR = TEMPLATE_DIR;
+exports.scaffold = scaffold;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scaffold.ts"],"names":["join","dirname","fileURLToPath","basename","resolve","mkdir","readdir","readFile","writeFile"],"mappings":";;;;;;;;AAIA,IAAM,YAAA,GAAeA,UAAKC,YAAA,CAAQC,iBAAA,CAAc,2PAAe,CAAC,GAAG,IAAI,CAAA;AAEhE,IAAM,YAAA,GAAeF,SAAA,CAAK,YAAA,EAAc,UAAU;AAEzD,IAAM,SAAA,GAA2D;AAAA,EAC/D,gBAAA,EAAkB,CAAC,SAAA,KAAcG,aAAA,CAAS,SAAS;AACrD,CAAA;AAEA,eAAsB,SAAS,SAAA,EAAoC;AACjE,EAAA,MAAM,MAAA,GAASC,aAAQ,SAAS,CAAA;AAChC,EAAA,MAAMC,cAAA,CAAM,MAAA,EAAQ,EAAE,SAAA,EAAW,MAAM,CAAA;AACvC,EAAA,MAAM,QAAA,CAAS,cAAc,MAAM,CAAA;AACnC,EAAA,OAAO,MAAA;AACT;AAEA,eAAe,QAAA,CAAS,MAAc,EAAA,EAA2B;AAC/D,EAAA,MAAM,UAAU,MAAMC,gBAAA,CAAQ,MAAM,EAAE,aAAA,EAAe,MAAM,CAAA;AAC3D,EAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,IAAA,MAAM,GAAA,GAAMN,SAAA,CAAK,IAAA,EAAM,KAAA,CAAM,IAAI,CAAA;AACjC,IAAA,MAAM,IAAA,GAAOA,SAAA,CAAK,EAAA,EAAI,KAAA,CAAM,IAAI,CAAA;AAChC,IAAA,IAAI,KAAA,CAAM,aAAY,EAAG;AACvB,MAAA,MAAMK,cAAA,CAAM,IAAA,EAAM,EAAE,SAAA,EAAW,MAAM,CAAA;AACrC,MAAA,MAAM,QAAA,CAAS,KAAK,IAAI,CAAA;AAAA,IAC1B,CAAA,MAAO;AACL,MAAA,IAAI,IAAA,GAAO,MAAME,iBAAA,CAAS,GAAA,EAAK,MAAM,CAAA;AACrC,MAAA,KAAA,MAAW,CAAC,KAAA,EAAOH,QAAO,KAAK,MAAA,CAAO,OAAA,CAAQ,SAAS,CAAA,EAAG;AACxD,QAAA,IAAA,GAAO,IAAA,CAAK,UAAA,CAAW,KAAA,EAAOA,QAAAA,CAAQ,EAAE,CAAC,CAAA;AAAA,MAC3C;AACA,MAAA,MAAMI,kBAAA,CAAU,IAAA,EAAM,IAAA,EAAM,MAAM,CAAA;AAAA,IACpC;AAAA,EACF;AACF","file":"index.cjs","sourcesContent":["import { mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PROJECT_ROOT = join(dirname(fileURLToPath(import.meta.url)), \"..\");\n\nexport const TEMPLATE_DIR = join(PROJECT_ROOT, \"template\");\n\nconst VARIABLES: Record<string, (targetDir: string) => string> = {\n  \"<PACKAGE_NAME>\": (targetDir) => basename(targetDir),\n};\n\nexport async function scaffold(targetDir: string): Promise<string> {\n  const target = resolve(targetDir);\n  await mkdir(target, { recursive: true });\n  await copyTree(TEMPLATE_DIR, target);\n  return target;\n}\n\nasync function copyTree(from: string, to: string): Promise<void> {\n  const entries = await readdir(from, { withFileTypes: true });\n  for (const entry of entries) {\n    const src = join(from, entry.name);\n    const dest = join(to, entry.name);\n    if (entry.isDirectory()) {\n      await mkdir(dest, { recursive: true });\n      await copyTree(src, dest);\n    } else {\n      let data = await readFile(src, \"utf8\");\n      for (const [token, resolve] of Object.entries(VARIABLES)) {\n        data = data.replaceAll(token, resolve(to));\n      }\n      await writeFile(dest, data, \"utf8\");\n    }\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+declare const TEMPLATE_DIR: string;
+declare function scaffold(targetDir: string): Promise<string>;
+
+export { TEMPLATE_DIR, scaffold };

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+declare const TEMPLATE_DIR: string;
+declare function scaffold(targetDir: string): Promise<string>;
+
+export { TEMPLATE_DIR, scaffold };

package/dist/index.js

@@ -0,0 +1,3 @@
+export { TEMPLATE_DIR, scaffold } from './chunk-H36REW25.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "seyfert-bot-starter",
+  "version": "1.0.0",
+  "description": "Scaffold a modern Seyfert Discord bot with one command. Bun + TypeScript + Biome, zero configuration.",
+  "keywords": [
+    "discord",
+    "seyfert",
+    "bot",
+    "starter",
+    "scaffold",
+    "boilerplate",
+    "create",
+    "typescript",
+    "bun",
+    "slash-commands"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Razi",
+    "url": "https://github.com/knownasrazi"
+  },
+  "type": "module",
+  "bin": {
+    "create-seyfert-bot": "./dist/cli.js"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "engines": {
+    "node": ">=18",
+    "bun": ">=1.0"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check --diagnostic-level=warn .",
+    "format": "biome format --write .",
+    "release": "bun run lint && bun run typecheck && bun run build && bun test"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.7",
+    "@types/bun": "^1.2.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.0"
+  }
+}

package/template/.env.example

@@ -0,0 +1,2 @@
+BOT_TOKEN=your_bot_token_here
+CLIENT_ID=your_application_id

package/template/README.md

@@ -0,0 +1,22 @@
+# <PACKAGE_NAME>
+
+A Seyfert bot scaffolded with [seyfert-bot-starter](https://github.com/knownasrazi/seyfert-bot-starter).
+
+## setup
+
+```bash
+cp .env.example .env
+# paste your BOT_TOKEN into .env
+bun install
+```
+
+## run
+
+```bash
+bun run dev    # watch mode
+bun run start  # production
+```
+
+## commands
+
+Every file under `src/commands/` is auto-registered. Start with `src/commands/ping.ts` and add more.

package/template/biome.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.5.12/schema.json",
+  "files": {
+    "includes": ["**", "!**/dist", "!**/coverage", "!**/node_modules", "!**/bun.lock"]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 120,
+    "formatWithErrors": false
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "preset": "recommended"
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "always",
+      "trailingCommas": "all"
+    }
+  }
+}

package/template/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "<PACKAGE_NAME>",
+  "version": "0.0.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "bun --watch src/index.ts",
+    "start": "bun src/index.ts",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit",
+    "format": "biome format --write ."
+  },
+  "dependencies": {
+    "@dotenvx/dotenvx": "^1.40.2",
+    "seyfert": "^5.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.7",
+    "@types/bun": "^1.2.2",
+    "typescript": "^5.9.0"
+  }
+}

package/template/src/commands/ping.ts

@@ -0,0 +1,11 @@
+import { Command, type CommandContext, Declare } from "seyfert";
+
+@Declare({
+  name: "ping",
+  description: "Reply with pong",
+})
+export default class PingCommand extends Command {
+  run(ctx: CommandContext) {
+    return ctx.write({ content: "Pong!" });
+  }
+}

package/template/src/index.ts

@@ -0,0 +1,16 @@
+import "@dotenvx/dotenvx/config";
+import { Client } from "seyfert";
+
+const client = new Client({
+  intents: ["Guilds", "GuildMembers", "GuildMessages", "MessageContent"],
+  locations: {
+    base: "src",
+    commands: "commands",
+  },
+});
+
+client.once("ready", () => {
+  console.log("[seyfert] bot is online");
+});
+
+void client.start();

package/template/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "types": ["@types/bun"],
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "verbatimModuleSyntax": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  },
+  "include": ["src"]
+}