# Changelog

All notable changes to `discgen-cli` will be documented here.
Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
Versioning follows [Semantic Versioning](https://semver.org/).

---

## [2.0.0] — 2026-06-02

### Breaking

- **Node.js baseline bumped to `>=24`** for `discgen-cli` and all generated projects.
- Generated CI now targets **Node 24 LTS** instead of older Node matrices.

### Added

- **`discgen-cli list`** — prints available presets, command types, features, databases, and generate types.
- **`--output <dir>`** — scaffold into an explicit output directory while keeping the package name separate.
- **`.discgen.json`** — generated projects now include generator metadata for future `doctor` and `upgrade` workflows.
- **`typecheck` script** — added to generated projects and release validation.

### Changed

- Updated CLI dependencies, including `commander@15`.
- Updated generated bot dependency baselines, including `discord.js@^14.26.4`, `typescript@^6.0.3`, ESLint 10, and Node 24 type definitions.
- Project name validation now follows npm package-name expectations more closely.
- Generated file names are validated as safe lowercase kebab-case module names.
- Next-step output now respects `--output <dir>`.
- TODO roadmap was restructured into release, UX, template quality, feature, upgrade, and publishing tracks.

### Fixed

- Generated `cooldown.ts` no longer includes an unused `seconds` parameter in `getRemainingCooldown`.
- Generated project CI no longer tests unsupported Node versions.
- CLI help text for `generate` no longer lists only a subset of supported generate types.

### Tests

- 189 tests passing.
- Full preset smoke-tested with dependency install, typecheck, lint, and build.

---

## [1.5.0] — 2026-05-04

### Added

- **`src/utils/embed.ts`** — typed `Embed.success/error/info/warn/default()` builder with consistent colour palette, optional fields, footer, thumbnail and timestamp; included in every generated project automatically
- **`src/utils/paginator.ts`** — reusable embed paginator using Components v2 (`ContainerBuilder`, `TextDisplayBuilder`, `SeparatorBuilder`); ⏮◀ X/Y ▶⏭ navigation, idle timeout, per-user collector, auto-disables on end; exported `Page` interface
- **i18n feature** — wizard-selectable `i18n` option generates:
  - `src/i18n/en.ts` — typed `Locale` interface + full English locale (`as const` pattern replaced with explicit interface for type safety)
  - `src/i18n/de.ts` — German locale satisfying `Locale` type
  - `src/i18n/index.ts` — `useT(guildId)`, `setGuildLocale()`, `getLocale()`, `supportedLocales`
  - `src/commands/utility/locale.ts` — `/locale` slash command with `ManageGuild` permission
- **Yarn support** — package manager detection now recognises `yarn.lock` and generates correct install commands
- **`PackageManager` type** extended with `'yarn'`
- **`Feature` type** extended with `'i18n'`

### Changed

- **Native `node:fs/promises`** replaces `fs-extra` — `ensureDir` → `fs.mkdir({ recursive: true })`, `removeDir` → `fs.rm({ recursive: true, force: true })`; zero external dependency
- **Native lockfile sniffing** replaces `detect-package-manager` — checks `bun.lock`, `bun.lockb`, `pnpm-lock.yaml`, `yarn.lock` in order; synchronous, zero dependency
- **`fs-extra`**, **`detect-package-manager`** and **`@types/fs-extra`** removed from `dependencies`

### Fixed

- **26 TypeScript errors in generated full-bot** fixed:
  - `Command.data` type widened to `SlashCommandBuilder | SlashCommandOptionsOnlyBuilder` — `.addXOption()` chains return the narrower type
  - All event `execute` signatures changed to `(...args: unknown[])` with internal casts — matches the dynamic event loader's spread call
  - `ping.ts` null-safe resource access: `sent.resource?.message?.createdTimestamp`
  - `paginator.ts` null-safe reply handle: `reply.resource?.message`
  - `handlers.ts` always-true condition `cmd?.execute` removed
  - `database/index.ts` BetterSqlite3 export type: explicit `db: BetterSqlite3Database` annotation
  - `i18n/de.ts` literal-type issue: `as const` replaced with explicit `interface Locale`
- **`--template + --no-install/--no-git` bug** — preset path in wizard now correctly applies `skipPrompts` overrides after spreading the preset, so `--no-install` and `--no-git` flags are respected even when a `--template` preset is used

### Tests

- 184 tests passing (up from 153)

---

## [1.4.0-hotfix.2] — 2026-05-01

### Fixed

- **`client.commands` undefined in all event handlers** — Discord.js only passes its own event arguments (e.g. `interaction`, `message`) to event listeners, never `client`. The event handler now appends the `client` variable from the outer scope: `execute(...args, client)`. Without this, every `execute(interaction, client)` call received `undefined` for `client`, crashing on `client.commands.get(...)`.

---

## [1.4.0-hotfix.1] — 2026-05-01

### Fixed

- **Slash commands not registering / not loading in dev mode** — all file scanners in generated bots now accept both `.ts` (tsx dev) and `.js` (compiled) files. The filter `f.endsWith('.js')` was silently finding zero files when running with `tsx watch src/index.ts` or `npm run deploy`. Changed to `/\.[jt]s$/.test(f) && !f.endsWith('.d.ts')` in `commandHandler`, `eventHandler`, `interactionLoader`, and `deploy-commands.ts`

---

## [1.4.0] — 2026-05-01

### Fixed

- **Prefix commands now work end-to-end** — `messageCreate` event routes to `client.prefixCommands`, `commandHandler` loads from `commands/prefix/` via `mod.default`, and `index.ts` declares + initializes the `prefixCommands: Collection<string, PrefixCommand>` on the Discord.js `Client`
- **Login log order** — generated `index.ts` now logs "Connecting to Discord..." _before_ `client.login()` instead of after
- **`deploy-commands.ts`** — skips `prefix/` directory (prefix commands have no `.data.toJSON()`) and adds `statSync` guard for non-directory entries
- **Node version check** — `checkNodeVersion()` now enforces `>= 22` (was `>= 18`); generated bots set `engines.node: >=22`
- **`.env.example`** — includes `PREFIX=!` when `commandType` is `prefix` or `both`
- **`generate` error message** — lists all type aliases including new `service`/`svc`

### Added

- **`/avatar` slash command** — added to the `utility` feature; shows a user's avatar in a Components v2 container with a "Open full size" link button
- **`generate service` subcommand** — `discgen-cli g service <name>` (alias `svc`) generates a singleton service class in `src/services/<name>.ts`
- **Economy commands are now database-aware** — when `sqlite` is selected, `balance`/`daily`/`leaderboard` use `better-sqlite3` prepared statements; when `postgresql`, they use async drizzle-orm queries; no-database bots keep the in-memory Map fallback
- **SQLite schema** — `users` table gains a `last_daily INTEGER` column used by the `daily` command
- **PostgreSQL schema** — `users` table gains a `lastDaily: timestamp` column used by the `daily` command
- **`vitest.config.ts`** — adds `pool: 'forks'` to fix parallel module-loading failures on Windows
- **Dynamic `/help` command** — lists exactly the commands present in the scaffolded bot based on the selected features
- **Prefix `/help` command** — shows a plain text command list, auto-populated with selected features

### Tests

- 153 tests passing (up from 110)

---

## [1.3.3] — 2026-05-01

### Changed

- Generated bot dependencies updated to current latest versions: `discord.js@^14.26.3`, `dotenv@^17.4.2`, `typescript@^5.9.3`, `tsx@^4.21.0`, `tsup@^8.5.1`, `eslint@^9.39.4`, `@typescript-eslint@^8.59.1`, `prettier@^3.8.3`, `better-sqlite3@^12.9.0`, `drizzle-orm@^0.45.2`, `pg@^8.20.0`
- Generated bot Node.js engine requirement bumped to `>=22` (LTS)
- README updated to use `banner.png` + `icon.png` from assets

---

## [1.3.2] — 2026-05-01

### Fixed

- Generated bot `package.json` now uses `"latest"` for all dependencies — fixes `npm install` failures caused by pinned versions that didn't exist yet
- Generated bot build script corrected: `tsup --format esm` (matches `"type": "module"`) and `start` uses `node dist/index.js`

---

## [1.3.0] — 2026-05-01

### Added

- **Component interactions system** — generated bots now have full routing for all Discord interaction types:
  - `src/interactions/buttons/` — button click handlers (`ButtonHandler` interface)
  - `src/interactions/selects/` — select menu handlers (`SelectHandler` interface)
  - `src/interactions/modals/` — modal submit handlers (`ModalHandler` interface)
  - `src/handlers/interactionLoader.ts` — automatically loads all handlers from disk at startup
  - `client.buttons`, `client.selects`, `client.modals` Collections added to the Discord.js `Client` type
  - `interactionCreate` event now routes slash commands **and** buttons, selects, and modals — each with isolated error handling and logging
- **`components` wizard feature** — adds example handlers + a full `/demo` slash command showcasing a Components v2 layout with buttons, select menus, and a modal form; included automatically in the `full` preset
- **`generate button/select/modal` subcommand** — `discgen-cli g button <name>` / `discgen-cli g select <name>` / `discgen-cli g modal <name>` generates a ready-to-use handler in `src/interactions/`
  - Short aliases: `btn`/`b`, `sel`/`s`, `m`
- **`ButtonHandler` / `SelectHandler` / `ModalHandler`** added to generated bot's `src/types/index.ts`
- **`src/utils/env.ts`** imported in generated `src/index.ts` — `env.DISCORD_TOKEN` used for `client.login()` instead of raw `process.env`

### Changed

- Command type prompt now defaults to **Slash Commands** (Slash is the modern standard); Prefix and Both options remain available
- `full` preset now includes the `components` feature and uses `commandType: 'both'`
- Generated `src/handlers/commandHandler.ts` uses `statSync` to robustly skip non-directory entries in the commands folder

### Tests

- 110 tests passing (up from 81)

---

## [1.2.0] — 2026-05-01

### Added

- **`discgen-cli generate` subcommand** (alias: `g`) — generate individual files into an existing bot project, similar to `nest generate`:
  - `discgen-cli g command <name>` — slash command (`export default { data, execute } satisfies Command`)
  - `discgen-cli g command <name> --prefix` — prefix command (`PrefixCommand` interface)
  - `discgen-cli g event <name>` — event handler; picks from 15 known Discord events with a select prompt
  - `discgen-cli g guard <name>` — standalone permission/cooldown guard function
  - `--category <folder>` — command subfolder (default: `utility`, prompt if omitted)
  - `--dry-run` — preview path without writing
  - Overwrite confirmation when target file already exists
  - Short type aliases: `cmd` / `c`, `evt` / `e`, `gd`
- **`--template <preset>` flag** — skip the interactive wizard with a preset: `basic`, `moderation`, or `full`
  - `basic` — slash commands, no features, no database
  - `moderation` — slash commands, moderation + utility features, no database
  - `full` — slash + prefix, all features, SQLite
- **Env validator template** (`src/utils/env.ts`) — generated bots now ship with a typed env validation module that checks `DISCORD_TOKEN` and `CLIENT_ID` on startup and exits with a clear error if any are missing
- **Cooldown utility template** (`src/utils/cooldown.ts`) — per-user command cooldown helper with auto-cleanup to prevent memory leaks
- **Help command template** (`src/commands/utility/help.ts`) — auto-generated `/help` command using Components v2 for slash bots; plain message reply for prefix bots

### Fixed

- `src/index.ts`: replaced `createRequire(import.meta.url)` (invalid in CJS output) with `readFileSync` + `__dirname` to read version from `package.json`
- `src/templates/commands/help.ts`: corrected type names (`Command` / `PrefixCommand`) and switched to `export default { data, execute } satisfies Command` pattern matching all other command templates

### Tests

- 81 tests passing (up from 40)

---

## [1.1.1] — 2026-05-01

### Fixed

- Release workflow split into two independent jobs so GitHub Release is created even if npm publish fails
- Replaced `softprops/action-gh-release` with `gh release create` (pre-installed GitHub CLI) for more reliable release creation
- CI matrix corrected: Node 18 removed — `vitest` v4 requires Node >= 20 (`node:util styleText` not available in Node 18)

---

## [1.1.0] — 2026-05-01

### Added

- **Logger template** — every generated bot now ships with `src/utils/logger.ts`:
  - Zero dependencies (pure Node.js, no pino/winston)
  - Log levels: `debug`, `info`, `warn`, `error` with ANSI colors + icons
  - Context parameter: `logger.info('msg', 'ready')` → `[ready]` tag in output
  - Error stack traces automatically appended on `logger.error()`
  - `LOG_LEVEL` env var support (default: `info`)
  - `error` → `stderr`, all others → `stdout`
- **Logger wired into generated bot** — `ready.ts`, `interactionCreate.ts` and `index.ts` all use the logger instead of `console.log/error`
- **`unhandledRejection` handler** in generated `index.ts` — logs uncaught errors via `logger.error`
- **GitHub Actions CI** (`.github/workflows/ci.yml`) — Node 18/20/22 matrix, runs lint + build + tests on push/PR to discgen-cli repo
- **GitHub Actions Release** (`.github/workflows/release.yml`) — auto-publishes to npm and creates a GitHub Release on `v*` tag push

### How to use auto-release

```bash
# bump version in package.json, then:
git tag v1.1.0
git push origin v1.1.0
# → CI runs, npm publish fires, GitHub Release is created automatically
```

---

## [1.0.1] — 2026-05-01

### Fixed

- README banner now uses the correct SVG logo (`assets/logo.svg`) — the `assets/banner.png` reference was broken
- Added `📦 Installation` section to README with all three usage options (npx, global install, local dependency) — usage after `npm install discgen-cli` was previously undocumented

---

## [1.0.0] — 2026-05-01

### Added

- Interactive wizard via `@clack/prompts` (project name, command type, features, database, package manager, git, install)
- Argument parsing via `commander`: positional `[name]`, `--no-install`, `--no-git`, `--dry-run`
- `--dry-run` flag: previews all files that would be generated without writing to disk
- Node.js version guard — exits with a clear error on Node < 18
- Overwrite confirmation when target directory already exists
- "Next steps" output after successful scaffolding
- Package manager auto-detection (`npm` / `pnpm` / `bun`)
- Git repository initialization + initial commit after scaffolding

### Templates

- Base bot: `src/index.ts`, `src/types/index.ts`, command handler, event handler, `deploy-commands.ts`
- Slash Commands, Prefix Commands, or Both
- Moderation commands: `ban`, `kick`, `timeout`, `warn`
- Utility commands: `ping`, `userinfo`, `serverinfo` — Discord Components v2
- Fun commands: `coinflip`, `8ball`, `meme` — Discord Components v2
- Economy commands: `balance`, `daily`, `leaderboard` — Discord Components v2
- Music commands: `play`, `stop` (placeholder, requires `@discordjs/voice`)
- SQLite database setup via `better-sqlite3`
- PostgreSQL database setup via `pg` + `drizzle-orm`
- Auto-generated `README.md`, `.env.example`, `.gitignore`, `tsconfig.json`, `eslint.config.mjs`, `.prettierrc`
- GitHub Actions CI workflow (`.github/workflows/ci.yml`) — Node 18/20/22 matrix

### Tech Stack

- CLI: `@clack/prompts` ^1.3, `commander` ^14, `fs-extra` ^11, `detect-package-manager` ^3
- Build: `tsup` ^8.5, `tsx` ^4.21, `typescript` ^6
- Lint: `eslint` ^10 (flat config), `@typescript-eslint` ^8
- Tests: `vitest` ^4 — 32 unit tests
- Generated bot targets: `discord.js` ^14.18, `dotenv` ^16