create-seedcord 0.4.2 → 0.5.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-seedcord",
   "type": "module",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Scaffold a new seedcord bot",
   "keywords": [
     "discord",
@@ -12,7 +12,7 @@
     "starter"
   ],
   "engines": {
-    "node": ">=24.11",
+    "node": "^24.22.1 || >=26.12.1",
     "bun": ">=1.4.2"
   },
   "bin": {
@@ -40,15 +40,15 @@
     "LICENSE"
   ],
   "devDependencies": {
-    "@clack/prompts": "^1.7.0",
-    "@seedcord/errors": "^0.13.0",
-    "@seedcord/eslint-config": "^2.5.0",
-    "@seedcord/tsconfig": "^2.0.6",
+    "@seedcord/cli-prompts": "^0.0.2",
+    "@seedcord/errors": "^0.14.0",
+    "@seedcord/eslint-config": "^3.0.0",
+    "@seedcord/tsconfig": "^3.0.0",
     "@seedcord/tsdown-config": "^2.0.1",
-    "@seedcord/types": "^0.14.4",
+    "@seedcord/types": "^0.15.0",
     "@seedcord/vitest-config": "^0.0.1",
     "discord.js": "^14.27.0",
-    "handlebars": "^4.7.9",
+    "handlebars": "^4.7.10",
     "package-manager-detector": "^1.8.0",
     "tsx": "^4.23.15",
     "typescript": "^6.0.3"
@@ -70,5 +70,5 @@
     "test:watch": "vitest dev",
     "coverage": "vitest run --coverage"
   },
-  "readme": "<div align=\"center\">\n  <picture>\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://cdn.seedcord.org/assets/wordmark-dark.webp\" />\n    <img src=\"https://cdn.seedcord.org/assets/wordmark-light.webp\" alt=\"seedcord\" width=\"440\" />\n  </picture>\n</div>\n\n<div align=\"center\">\n  <h3>The whole Discord bot, typed end to end</h3>\n  <a href=\"https://seedcord.org\">Website</a> ·\n  <a href=\"https://seedcord.org/guide\">Guide</a> ·\n  <a href=\"https://seedcord.org/docs\">Reference</a> ·\n  <a href=\"https://discord.gg/DzFxY58WXf\">Discord</a>\n</div>\n\n<br />\n\n<div align=\"center\">\n\n[![npm](https://img.shields.io/npm/v/create-seedcord?style=flat-square&label=npm&labelColor=1f1f1f&color=c8341f)](https://www.npmjs.com/package/create-seedcord) [![node](https://img.shields.io/node/v/create-seedcord?style=flat-square&label=node&labelColor=1f1f1f&color=4d7d33)](https://nodejs.org) [![bun](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fseedcord%2Fseedcord%2Fnext%2Fcli%2Fcreate-seedcord%2Fpackage.json&query=%24.engines.bun&style=flat-square&label=bun&labelColor=1f1f1f&color=fbf0df)](https://bun.com) [![license](https://img.shields.io/npm/l/create-seedcord?style=flat-square&label=license&labelColor=1f1f1f&color=f8f6e8)](LICENSE)\n\n</div>\n\n## About\n\n`create-seedcord` scaffolds a new seedcord bot project.\n\nUntil v1.0.0, minor versions can break.\n\n## Usage\n\n```sh\npnpm create seedcord my-bot\nnpm create seedcord my-bot\nyarn create seedcord my-bot\n```\n\nIt asks where the project goes, how Discord reaches your bot, what the bot should react to, your bot token, your app public key on http, and an accent color. Then it writes the project, installs dependencies, formats, generates your command types, and makes the first commit. If a step after the write fails, you get a warning and the summary still prints.\n\nIf you don't have the token or key yet, press Enter twice on its prompt to skip it. Fill it into `.env` before you start the bot.\n\nOn Windows, run it from Windows Terminal. The prompts fall back to ASCII in `cmd.exe` making the boxes draw as `T`, `|`, and `o`.\n\n## Flags\n\nEvery question has a flag. Pass them all to skip all questions. `--help` prints the list.\n\nnpm forwards flags to the package only after a `--`:\n\n```sh\nnpm create seedcord my-bot -- --transport gateway --capabilities reactions\npnpm create seedcord my-bot --transport gateway --capabilities reactions\n```\n\n`--no-install` and `--no-git` turn off those two steps. `--no-token` and `--no-public-key` leave those keys empty without asking. `-v` prints the version and `-h` prints the flag list.\n\nWith no terminal to ask on, it reads the flags alone. It prints the flag that would supply any answer you left out.\n\n## What you get\n\nA TypeScript project holding one slash command, its handler, a sample event handler (if you picked `gateway`), `seedcord.config.ts`, eslint, prettier, and a `.env` listing every key the framework reads.\n\n`pnpm dev` starts it with hot reload. On the http transport it also opens a cloudflared tunnel and sets it up, and Discord posts interactions to that URL.\n"
+  "readme": "<div align=\"center\">\n  <picture>\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://cdn.seedcord.org/assets/wordmark-dark.webp\" />\n    <img src=\"https://cdn.seedcord.org/assets/wordmark-light.webp\" alt=\"seedcord\" width=\"440\" />\n  </picture>\n</div>\n\n<div align=\"center\">\n  <h3>The whole Discord bot, typed end to end</h3>\n  <a href=\"https://seedcord.org\">Website</a> ·\n  <a href=\"https://seedcord.org/guide\">Guide</a> ·\n  <a href=\"https://seedcord.org/docs\">Reference</a> ·\n  <a href=\"https://seedcord.org/chat/\">Discord</a>\n</div>\n\n<br />\n\n<div align=\"center\">\n\n[![npm](https://img.shields.io/npm/v/create-seedcord?style=flat-square&label=npm&labelColor=1f1f1f&color=c8341f)](https://www.npmjs.com/package/create-seedcord) [![node](https://img.shields.io/node/v/create-seedcord?style=flat-square&label=node&labelColor=1f1f1f&color=4d7d33)](https://nodejs.org) [![bun](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fseedcord%2Fseedcord%2Fnext%2Fcli%2Fcreate-seedcord%2Fpackage.json&query=%24.engines.bun&style=flat-square&label=bun&labelColor=1f1f1f&color=fbf0df)](https://bun.com) [![license](https://img.shields.io/npm/l/create-seedcord?style=flat-square&label=license&labelColor=1f1f1f&color=f8f6e8)](LICENSE)\n\n</div>\n\n## About\n\n`create-seedcord` sets up a new seedcord bot. It asks a few questions, writes the project, and can install its dependencies and make the first git commit. You run it once, when you start a new bot.\n\nseedcord is pre-1.0, so a minor version can break your bot. Each release's changelog says what changed and how to update.\n\n## Usage\n\n```sh\npnpm create seedcord my-bot\n```\n\n`npm create seedcord`, `yarn create seedcord`, and `bun create seedcord` work too, and the project uses that package manager.\n\nIt asks whether your bot is a gateway or an http bot, where an http bot runs, what a gateway bot reacts to, your bot token, and the servers to test your commands in. The [first bot guide](https://seedcord.org/guide/first-bot) walks through each question.\n\nEvery question has a flag, and `--help` prints them all. npm passes flags on only after a `--`:\n\n```sh\nnpm create seedcord my-bot -- --transport gateway --capabilities reactions\n```\n\n## What you get\n\nA TypeScript project with one slash command, its handler, a sample plugin, `seedcord.config.ts`, ESLint, Prettier, and a `.env` for your token. A gateway bot also gets a sample event handler. An http bot on Cloudflare Workers also gets a `cloudflare.config.ts` and a `deploy` script.\n\n`pnpm dev` starts the bot with hot reload.\n"
 }

package/templates/.vscode/settings.json.hbs

@@ -1,11 +1,13 @@
 {
   "files.watcherExclude": {
-    "**/seedcord-gen.d.ts": true
+    "**/seedcord-gen.d.ts": true,
+    "**/.seedcord/**": true
   },
   "search.exclude": {
     "**/seedcord-gen.d.ts": true
   },
   "files.readonlyInclude": {
-    "**/seedcord-gen.d.ts": true
+    "**/seedcord-gen.d.ts": true,
+    "**/.seedcord/**": true
   }
 }

package/templates/AGENTS.md.hbs

@@ -10,7 +10,7 @@ Rules for an AI coding agent working in this repo.
 
 The API reference is at <https://seedcord.org/docs>, one page per symbol.
 
-This project runs on the {{#if isGateway}}gateway{{else}}http{{/if}} transport and imports everything from `{{ transportPackage }}`. A page marks anything that differs between the two.
+This project runs on the {{#if isGateway}}gateway{{else}}http{{/if}} transport{{#if isEdge}} on Cloudflare Workers{{/if}} and imports everything from `{{ transportPackage }}`. A page marks anything that differs between the two transports.
 
 ## How a command works here
 
@@ -35,7 +35,7 @@ Run `{{ pm.run }} codegen` after you add a command or change its options. It wri
 
 ## Connections and state
 
-Anything that holds a connection, keeps state between interactions, or runs in the background belongs in a plugin, either an existing one or your own. Read <https://seedcord.org/guide/plugins.md> and <https://seedcord.org/guide/plugins/your-own.md> before you add one.
+Anything that holds a connection, keeps state between interactions, or runs in the background belongs in a plugin, either an existing one or your own. Read <https://seedcord.org/guide/plugins.md> and <https://seedcord.org/guide/writing-plugins.md> before you add one.
 
 ## Imports
 

package/templates/README.md.hbs

@@ -1,6 +1,6 @@
 # {{ projectName }}
 
-A Discord bot built with [seedcord](https://seedcord.org){{#if isGateway}} on the gateway transport{{else}} on the http transport{{/if}}.
+A Discord bot built with [seedcord](https://seedcord.org){{#if isGateway}} on the gateway transport{{else}} on the http transport{{#if isEdge}}, running on Cloudflare Workers{{/if}}{{/if}}.
 
 ## Running it
 
@@ -17,11 +17,22 @@ That starts the dev server with hot reload{{#unless isGateway}} and opens a tunn
 | script | what it does |
 | --- | --- |
 | `{{ pm.run }} dev` | dev server with hot reload |
+{{#if isEdge}}
+| `{{ pm.run }} build` | build the worker into `.cloudflare/output/` |
+| `{{ pm.run }} deploy` | build, then upload the worker with `cf deploy` |
+{{else}}
 | `{{ pm.run }} build` | compile to `dist/` |
 | `{{ pm.run }} start` | run the compiled build |
+{{/if}}
 | `{{ pm.run }} codegen` | regenerate `src/seedcord-gen.d.ts` |
-| `{{ pm.run }} lint` | eslint |
+{{#if isEdge}}
+| `{{ pm.run }} types` | regenerate the binding types in `.cloudflare/types/` |
+{{/if}}
+| `{{ pm.run }} commands` | list, deploy, or clean up your commands on Discord |
+| `{{ pm.run }} commands:deploy` | send your commands to Discord |
 | `{{ pm.run }} tc` | type-check |
+| `{{ pm.run }} lint` | eslint |
+| `{{ pm.run }} check` | type-check, lint, and check formatting |
 
 <!-- prettier-ignore-end -->
 
@@ -36,16 +47,28 @@ Run `codegen` after you add a command or change its options. It writes the types
 | key | required |
 | --- | --- |
 | `DISCORD_BOT_TOKEN` | yes |
-{{#unless isGateway}}
-| `DISCORD_PUBLIC_KEY` | yes |
-{{/unless}}
 | `UNKNOWN_EXCEPTION_WEBHOOK_URL` | no |
 | `HANDLED_EXCEPTION_WEBHOOK_URL` | no |
+| `TESTING_GUILD_IDS` | no, empty deploys your commands globally |
+{{#unless isEdge}}
 | `ENV` | no, defaults to `development` |
+{{/unless}}
 
 <!-- prettier-ignore-end -->
 
 The two webhook keys take Discord webhook URLs. Set them to get error reports posted to a channel.
+{{#if isEdge}}
+
+A worker gets only the keys that `cloudflare.config.ts` declares. Add a line there for each new one your bot reads. `{{ pm.run }} dev` takes their values from `.env`.
+
+Cloudflare refuses to deploy a new worker until every declared secret has a value. Put the production values in a file like `.env.production`, then deploy the first time with:
+
+```sh
+{{ pm.run }} build && {{ pm.exec }} cf deploy --prebuilt --secrets-file .env.production
+```
+
+After that, `{{ pm.run }} deploy` is enough. `TESTING_GUILD_IDS` can stay empty there, since a deployed worker never deploys commands.
+{{/if}}
 
 ## Where things go
 

package/templates/bunfig.toml.hbs

@@ -1,4 +1,4 @@
-{{#if pm.isBun}}
+{{#if cliOnBun}}
 [run]
 bun = true
 {{/if}}

package/templates/cloudflare.config.ts.hbs

@@ -0,0 +1,18 @@
+{{#if isEdge}}
+import { bindings, defineConfig } from 'cf/config';
+
+// cf workers types calls this without a mode
+export default defineConfig(({ mode = 'production' }) => ({
+    worker: {
+        name: '{{ projectName }}',
+        compatibilityDate: '2026-08-04',
+        env: {
+            DISCORD_BOT_TOKEN: bindings.secret(),
+            UNKNOWN_EXCEPTION_WEBHOOK_URL: bindings.secret(),
+            HANDLED_EXCEPTION_WEBHOOK_URL: bindings.secret(),
+            TESTING_GUILD_IDS: bindings.secret(),
+            ENV: bindings.text(mode)
+        }
+    }
+}));
+{{/if}}

package/templates/env.hbs

@@ -1,13 +1,13 @@
 # Your bot token, from the Bot page of your app in the Discord Developer Portal
 DISCORD_BOT_TOKEN={{ token }}
-{{#unless isGateway}}
-
-# Public key, from the General Information page of the same app
-DISCORD_PUBLIC_KEY={{ publicKey }}
-{{/unless}}
 
 # Discord webhooks the framework posts error reports to. Leave empty to skip reporting.
 UNKNOWN_EXCEPTION_WEBHOOK_URL=
 HANDLED_EXCEPTION_WEBHOOK_URL=
 
+# Comma-separated ids of the servers your commands deploy to while you build. Leave empty to deploy globally.
+TESTING_GUILD_IDS={{ testingGuildIds }}
+{{#unless isEdge}}
+
 ENV=development
+{{/unless}}

package/templates/gitattributes.hbs

@@ -0,0 +1,3 @@
+* text=auto eol=lf
+
+seedcord-gen.d.ts linguist-generated

package/templates/gitignore.hbs

@@ -1,12 +1,18 @@
 node_modules/
 dist/
-logs/
+/logs/
 *.log
 *.tsbuildinfo
 .eslintcache
 .seedcord/
+{{#if isEdge}}
+.cloudflare/
+{{/if}}
 
 .env*
 !.env.example
+{{#if isEdge}}
+.dev.vars*
+{{/if}}
 
 .DS_Store

package/templates/package.json.hbs

@@ -4,17 +4,28 @@
     "version": "0.1.0",
     "private": true,
     "engines": {
-        {{#if pm.isBun}}"bun": "{{ engines.bun }}"{{else}}"node": "{{ engines.node }}"{{/if}}
+        {{#if cliOnBun}}"bun": "{{ engines.bun }}"{{else}}"node": "{{ engines.node }}"{{/if}}
     },
     "scripts": {
         "dev": "seedcord dev",
         "build": "seedcord build",
+{{#if isEdge}}
+        "deploy": "seedcord build && cf deploy --prebuilt",
+{{else}}
         "start": "node --enable-source-maps dist/index.mjs",
+{{/if}}
         "codegen": "seedcord codegen",
-        "lint": "eslint 'src/**/*.ts' --cache",
-        "lint:fix": "eslint 'src/**/*.ts' --fix --cache",
-        "fmt": "prettier --write 'src/**/*.{ts,json,md}' --cache",
-        "fmt:check": "prettier --check 'src/**/*.{ts,json,md}' --cache",
-        "tc": "tsc --noEmit"
+{{#if isEdge}}
+        "types": "cf workers types",
+{{/if}}
+        "commands": "seedcord commands",
+        "commands:deploy": "seedcord commands deploy",
+        "tc": "tsc --noEmit",
+        "lint": "eslint \"src/**/*.ts\" --cache",
+        "lint:fix": "eslint \"src/**/*.ts\" --fix --cache",
+        "fmt": "prettier --write \"src/**/*.{ts,json,md}\" --cache",
+        "fmt:check": "prettier --check \"src/**/*.{ts,json,md}\" --cache",
+        "check": "{{ pm.run }} tc && {{ pm.run }} lint && {{ pm.run }} fmt:check"{{#if isEdge}},
+        "postinstall": "cf workers types"{{/if}}
     }
 }

package/templates/pnpm-workspace.yaml.hbs

@@ -0,0 +1,7 @@
+{{#if pm.isPnpm}}
+allowBuilds:
+    unrs-resolver: false
+{{#if isEdge}}
+    workerd: true
+{{/if}}
+{{/if}}

package/templates/seedcord.config.ts.hbs

@@ -3,12 +3,11 @@ import { defineConfig } from 'seedcord';
 export default defineConfig({
     root: './src',
     instance: './bot.ts',
-    entry: './index.ts',
+{{#unless isEdge}}
+    build: { start: './index.ts' },
+{{/unless}}
     // set false to hold the running arc and live dot still, which cuts idle redraws by ~80%
     idleAnimation: true,
-    build: {
-        tsconfig: './tsconfig.build.json'
-    },
     hmr: {
         // set true to run tsc --watch alongside the bot, at the cost of a second node process
         typecheck: false

package/templates/src/bot.ts.hbs

@@ -1,14 +1,12 @@
-import { resolve } from 'node:path';
-
 {{#if isGateway}}
 import { Seedcord } from '@seedcord/gateway';
 import { GatewayIntentBits{{#if partials}}, Partials{{/if}} } from 'discord.js';
 {{else}}
 import { Seedcord } from '@seedcord/http';
 {{/if}}
-import { Envapter } from 'envapt';
+import { Converters, Envapter } from 'envapt';
 
-Envapter.baseDir = resolve(import.meta.dirname, '..');
+import { Uptime } from '#plugins/Uptime'
 
 export const seedcord = new Seedcord({
     bot: {
@@ -23,13 +21,14 @@ export const seedcord = new Seedcord({
         },
 {{/if}}
         interactions: {
-            path: resolve(import.meta.dirname, './handlers')
+            path: './handlers'
         },
         commands: {
-            path: resolve(import.meta.dirname, './commands')
+            path: './commands',
+            guilds: Envapter.getAs('TESTING_GUILD_IDS', Converters.array(), [])
         }{{#if isGateway}},
         events: {
-            path: resolve(import.meta.dirname, './events')
+            path: './events'
         }{{/if}}
     },
     subscribers: {
@@ -39,6 +38,6 @@ export const seedcord = new Seedcord({
     notifications: {
         developerUsername: '{{ developerUsername }}'
     }
-});
+}).attach('uptime', Uptime);
 
 export default seedcord;

package/templates/src/commands/Ping.ts.hbs

@@ -1,6 +1,6 @@
 import { BuilderComponent, RegisterCommand } from '{{ transportPackage }}';
 
-@RegisterCommand('global')
+@RegisterCommand()
 export class Ping extends BuilderComponent<'command'> {
     constructor() {
         super('command');

package/templates/src/handlers/Ping.ts.hbs

@@ -1,4 +1,4 @@
-import { SlashHandler, SlashRoute, timestampFromSnowflake } from '{{ transportPackage }}';
+import { SlashHandler, SlashRoute, timestampFromSnowflake, toEpochSeconds } from '{{ transportPackage }}';
 
 @SlashRoute('ping')
 export class Ping extends SlashHandler<'ping'> {
@@ -7,7 +7,7 @@ export class Ping extends SlashHandler<'ping'> {
         const lines = ['### Pong', `Roundtrip **${roundtrip}ms**`];
 
         if (this.options.getBoolean('detailed')) {
-            lines.push(`Uptime **${Math.round(process.uptime())}s**`);
+            lines.push(`Up since **<t:${toEpochSeconds(this.core.uptime.startedAt)}:R>**`);
         }
 
         await this.reply(lines.join('\n'));

package/templates/src/index.ts.hbs

@@ -1,3 +1,5 @@
+{{#unless isEdge}}
 import seedcord from './bot';
 
 await seedcord.start();
+{{/unless}}

package/templates/src/plugins/Uptime.ts.hbs

@@ -0,0 +1,16 @@
+import { Plugin } from '{{ transportPackage }}';
+
+import type { EpochMs } from '{{ transportPackage }}';
+
+export class Uptime extends Plugin {
+    public startedAt = 0 as EpochMs;
+
+    public async init(): Promise<void> {
+        this.startedAt = Date.now() as EpochMs;
+        await Promise.resolve();
+    }
+
+    public elapsed(): number {
+        return Date.now() - this.startedAt;
+    }
+}

package/templates/tsconfig.json.hbs

@@ -3,8 +3,24 @@
     "extends": "@seedcord/tsconfig/node",
     "compilerOptions": {
         "rootDir": "./",
-        "outDir": "./dist"
+        "outDir": "./dist",
+        "types": ["node", "vite/client"],
+{{#if isEdge}}
+        "customConditions": ["workerd"],
+{{/if}}
+        "paths": {
+            "#src/*": ["./src/*"],
+            "#components/*": ["./src/components/*"],
+            "#plugins/*": ["./src/plugins/*"]
+        }
     },
-    "include": ["src/**/*.ts", "eslint.config.ts", "prettier.config.ts", "seedcord.config.ts"],
+    "include": [
+        "src/**/*.ts",
+        "eslint.config.ts",
+        "prettier.config.ts",
+        "seedcord.config.ts"{{#if isEdge}},
+        "cloudflare.config.ts",
+        ".cloudflare/types/index.d.ts"{{/if}}
+    ],
     "exclude": ["node_modules", "dist"]
 }