create-seedcord 0.3.2 → 0.4.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-seedcord",
   "type": "module",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Scaffold a new seedcord bot",
   "keywords": [
     "discord",
@@ -40,16 +40,16 @@
   ],
   "devDependencies": {
     "@clack/prompts": "^1.7.0",
-    "@seedcord/errors": "^0.10.0",
-    "@seedcord/eslint-config": "^2.2.1",
-    "@seedcord/tsconfig": "^2.0.3",
+    "@seedcord/errors": "^0.12.0",
+    "@seedcord/eslint-config": "^2.3.0",
+    "@seedcord/tsconfig": "^2.0.5",
     "@seedcord/tsdown-config": "^2.0.1",
-    "@seedcord/types": "^0.14.0",
+    "@seedcord/types": "^0.14.2",
     "@seedcord/vitest-config": "^0.0.1",
     "discord.js": "^14.27.0",
     "handlebars": "^4.7.9",
     "package-manager-detector": "^1.8.0",
-    "tsx": "^4.23.5",
+    "tsx": "^4.23.15",
     "typescript": "^6.0.3"
   },
   "publishConfig": {
@@ -69,5 +69,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, wired and typed</h3>\n  <a href=\"https://seedcord.org\">Website</a> ·\n  <a href=\"https://guide.seedcord.org\">Guide</a> ·\n  <a href=\"https://docs.seedcord.org\">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&logo=npm&logoColor=c8341f&label=&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) [![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, and an accent color. Then it writes the project, installs, formats, generates your command types, and makes the first commit. A step that fails after the write becomes a warning. The summary still prints.\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. `-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://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&logo=npm&logoColor=c8341f&label=&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) [![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"
 }

package/templates/AGENTS.md.hbs

@@ -6,9 +6,9 @@ Rules for an AI coding agent working in this repo.
 
 ## Reading the docs
 
-<https://guide.seedcord.org/llms.txt> lists every page in the guide with a line on what it covers. Each page answers at its own url plus `.md`, so <https://guide.seedcord.org/commands/options.md> is the Options page as Markdown.
+<https://seedcord.org/guide/llms.txt> lists every page in the guide with a line on what it covers. Each page answers at its own url plus `.md`, so <https://seedcord.org/guide/commands/options.md> is the Options page as Markdown.
 
-The API reference is at <https://docs.seedcord.org>, one page per symbol.
+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.
 
@@ -33,6 +33,10 @@ Run `{{ pm.run }} codegen` after you add a command or change its options. It wri
 
 <!-- prettier-ignore-end -->
 
+## 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.
+
 ## Before you call it done
 
 Run `{{ pm.run }} tc` and `{{ pm.run }} lint`. A wrong route or a wrong option name is a compile error, so a green type-check catches most of what an invented API gets wrong.

package/templates/README.md.hbs

@@ -58,5 +58,5 @@ The two webhook keys take Discord webhook URLs. Set them to get error reports po
 
 ## Docs
 
-- Guide: <https://guide.seedcord.org>
-- API reference: <https://docs.seedcord.org>
+- Guide: <https://seedcord.org/guide>
+- API reference: <https://seedcord.org/docs>