feat: context, cache, macro and more

Author: twlite

apps/test-bot/.gitignore

@@ -1 +1,2 @@
-.env
+.env
+.commandkit

apps/test-bot/package.json

@@ -1,7 +1,10 @@
 {
   "name": "test-bot",
+  "version": "1.0.0",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "dev": "commandkit dev",
+    "build": "commandkit build",
+    "start": "commandkit start"
   },
   "dependencies": {
     "commandkit": "workspace:*",

apps/test-bot/src/commands/misc/dm-only.ts

@@ -0,0 +1,12 @@
+import { SlashCommandProps, CommandData, dmOnly } from 'commandkit';
+
+export const data: CommandData = {
+  name: 'dm-only',
+  description: 'This is a dm only command',
+};
+
+export async function run({ interaction }: SlashCommandProps) {
+  dmOnly();
+
+  await interaction.reply('This command can only be used in a dm.');
+}

apps/test-bot/src/commands/misc/guild-only.ts

@@ -0,0 +1,12 @@
+import { SlashCommandProps, CommandData, guildOnly } from 'commandkit';
+
+export const data: CommandData = {
+  name: 'guild-only',
+  description: 'This is a guild only command.',
+};
+
+export async function run({ interaction }: SlashCommandProps) {
+  guildOnly();
+
+  await interaction.reply('This command can only be used in a guild.');
+}

apps/test-bot/src/commands/misc/help.ts

@@ -0,0 +1,43 @@
+import { unstable_cache, SlashCommandProps, CommandData } from 'commandkit';
+import { setTimeout } from 'node:timers/promises';
+
+export const data: CommandData = {
+  name: 'help',
+  description: 'This is a help command.',
+};
+
+function $botVersion() {
+  'use macro';
+  // this function is inlined in production build
+  const process = require('node:process');
+  return require(`${process.cwd()}/package.json`).version;
+}
+
+async function someExpensiveDatabaseCall() {
+  await setTimeout(3000);
+  return Date.now();
+}
+
+export async function run({ interaction }: SlashCommandProps) {
+  await unstable_cache({ name: interaction.commandName, ttl: 60_000 });
+
+  await interaction.deferReply();
+
+  const time = await someExpensiveDatabaseCall();
+
+  const version = $botVersion();
+
+  return interaction.editReply({
+    embeds: [
+      {
+        title: 'Help',
+        description: `This is a help command. The current time is \`${time}\``,
+        color: 0x7289da,
+        footer: {
+          text: `Bot Version: ${version}`,
+        },
+        timestamp: new Date().toISOString(),
+      },
+    ],
+  });
+}

apps/test-bot/src/commands/misc/run-after.ts

@@ -0,0 +1,20 @@
+import { SlashCommandProps, CommandData, after } from 'commandkit';
+
+export const data: CommandData = {
+  name: 'run-after',
+  description: 'This is a run-after command',
+};
+
+export async function run({ interaction }: SlashCommandProps) {
+  after((env) => {
+    console.log(
+      `The command ${interaction.commandName} was executed successfully in ${env
+        .getExecutionTime()
+        .toFixed(2)} milliseconds!`,
+    );
+  });
+
+  await interaction.reply(
+    'Hello, you will see a new message printed in your console after this command runs.',
+  );
+}

apps/test-bot/src/index.ts

@@ -13,7 +13,7 @@ new CommandKit({
   validationsPath: `${__dirname}/validations`,
   devGuildIds: process.env.DEV_GUILD_ID?.split(',') ?? [],
   devUserIds: process.env.DEV_USER_ID?.split(',') ?? [],
-  bulkRegister: true,
+  bulkRegister: false,
 });
 
 await client.login(process.env.TOKEN);

packages/commandkit/bin/build.mjs

@@ -11,6 +11,7 @@ import {
   write,
 } from './common.mjs';
 import ora from 'ora';
+import { esbuildPluginUseMacro } from 'use-macro';
 
 export async function bootstrapProductionBuild(config) {
   const {
@@ -44,7 +45,9 @@ export async function bootstrapProductionBuild(config) {
       outDir,
       silent: true,
       watch: false,
+      cjsInterop: true,
       entry: [src, '!dist', '!.commandkit', `!${outDir}`],
+      esbuildPlugins: [esbuildPluginUseMacro()],
     });
 
     await injectShims(outDir, main, antiCrash, polyfillRequire);

packages/commandkit/bin/development.mjs

@@ -69,6 +69,7 @@ export async function bootstrapDevelopmentServer(opts) {
       silent: true,
       entry: [src, '!dist', '!.commandkit', `!${outDir}`].filter(Boolean),
       watch: watchMode,
+      cjsInterop: true,
       async onSuccess() {
         return await injectShims('.commandkit', main, false, requirePolyfill);
       },

packages/commandkit/package.json

@@ -47,7 +47,8 @@
     "ora": "^8.0.1",
     "rfdc": "^1.3.1",
     "rimraf": "^5.0.5",
-    "tsup": "^8.0.1"
+    "tsup": "^8.3.5",
+    "use-macro": "^1.0.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
@@ -56,7 +57,6 @@
     "tsconfig": "workspace:*",
     "tsx": "^4.7.0",
     "typescript": "^5.7.2",
-    "use-macro": "^1.0.1",
     "vitest": "^1.2.1"
   },
   "peerDependencies": {