commandkit 0.1.11-dev.20250406081911 → 0.1.11-dev.20250407135241

package/dist/index.d.ts

@@ -1717,6 +1717,35 @@ interface CommandKitConfiguration {
     getMessageCommandPrefix: (message: Message$1) => Awaitable<string | string[]>;
 }
 declare let commandkit: CommandKit;
+type BootstrapFunction = GenericFunction<[CommandKit]> | AsyncFunction<[CommandKit]>;
+/**
+ * Registers a bootstrap hook that will be called when the CommandKit instance is created.
+ * This is useful for plugins that need to run some code after the CommandKit instance is fully initialized.
+ * Note that not all commandkit dependiencs are available at this point. It is recommended to use the `onApplicationBootstrap` hook instead,
+ * if you need access to the commandkit dependencies.
+ * @param fn The bootstrap function to register.
+ * @example ```ts
+ * import { onBootstrap } from 'commandkit';
+ *
+ * onBootstrap(async (commandkit) => {
+ *   // Do something with the commandkit instance
+ * })
+ * ```
+ */
+declare function onBootstrap<F extends BootstrapFunction>(fn: F): void;
+/**
+ * Registers a bootstrap hook that will be called when the CommandKit instance is created.
+ * This is useful for plugins that need to run some code after the CommandKit instance is fully initialized.
+ * @param fn The bootstrap function to register.
+ * @example ```ts
+ * import { onApplicationBootstrap } from 'commandkit';
+ *
+ * onApplicationBootstrap(async (commandkit) => {
+ *   // Do something with the commandkit instance
+ * })
+ * ```
+ */
+declare function onApplicationBootstrap<F extends BootstrapFunction>(fn: F): void;
 declare class CommandKit extends EventEmitter {
     #private;
     private readonly options;
@@ -1970,4 +1999,4 @@ declare function devOnly<T extends (...args: any[]) => any>(fn: T): T;
  */
 declare function bootstrapCommandkitCLI(argv: string[], options?: commander.ParseOptions | undefined): Promise<void>;
 
-export { ActionRow, type ActionRowProps, type AnyCommandExecute, type AnyCommandKitElement, AppCommandHandler, type AsyncFunction, type AutocompleteCommand, type AutocompleteCommandContext, type AutocompleteCommandMiddlewareContext, Button, type ButtonChildrenLike, ButtonKit, type ButtonKitPredicate, type ButtonProps, COMMANDKIT_BOOTSTRAP_MODE, COMMANDKIT_CACHE_TAG, COMMANDKIT_IS_DEV, COMMANDKIT_IS_TEST, type CacheContext, type CacheEntry, type CacheMetadata, CacheProvider, ChannelSelectMenu, ChannelSelectMenuKit, type ChannelSelectMenuKitPredicate, type ChannelSelectMenuProps, type Command, type CommandBuilderLike, type CommandContext, type CommandContextOptions, type CommandData, CommandExecutionMode, CommandKit, type CommandKitButtonBuilderInteractionCollectorDispatch, type CommandKitButtonBuilderInteractionCollectorDispatchContextData, type CommandKitButtonBuilderOnEnd, type CommandKitConfiguration, type CommandKitElement, type CommandKitElementData, CommandKitEnvironment, type CommandKitEnvironmentInternalData, CommandKitEnvironmentType, type CommandKitHMREvent, type CommandKitLoggerOptions, type CommandKitModalBuilderInteractionCollectorDispatch, type CommandKitModalBuilderInteractionCollectorDispatchContextData, type CommandKitModalBuilderOnEnd, type CommandKitOptions, type CommandKitPlugin, CommandKitPluginRuntime, type CommandKitSelectMenuBuilderInteractionCollectorDispatch, type CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, type CommandKitSelectMenuBuilderOnEnd, CommandRegistrar, type CommandSource, type CommandTypeData, CommandsRouter, type CommandsRouterOptions, type CommonBuilderKit, type CommonPluginRuntime, type CommonSelectMenuProps, CompilerPlugin, CompilerPluginRuntime, Context, type ContextParameters, DefaultLogger, ElementType, EventInterceptor, type EventInterceptorContextData, type EventInterceptorErrorHandler, EventsRouter, type EventsRouterOptions, type EventsTree, Fragment, type FragmentElementProps, type GenericFunction, HMREventType, type ILogger, type InteractionCommandContext, type InteractionCommandMiddlewareContext, type LoadedCommand, type Loader, type Location, Logger, type LoggerImpl, type MaybeArray, type MaybeFalsey, MemoryCache, MentionableSelectMenu, MentionableSelectMenuKit, type MentionableSelectMenuKitPredicate, type MentionableSelectMenuProps, type Message, type MessageCommand, type MessageCommandContext, type MessageCommandMiddlewareContext, MessageCommandOptions, type MessageCommandOptionsSchema, MessageCommandParser, type MessageContextMenuCommand, type MessageContextMenuCommandContext, type MessageContextMenuCommandMiddlewareContext, type Middleware, MiddlewareContext, type MiddlewareContextArgs, Modal, ModalKit, type ModalKitPredicate, type ModalProps, type OnButtonKitClick, type OnButtonKitEnd, type OnChannelSelectMenuKitSubmit, type OnLoadArgs, type OnLoadOptions, type OnLoadResult, type OnMentionableSelectMenuKitSubmit, type OnModalKitEnd, type OnModalKitSubmit, type OnResolveArgs, type OnResolveOptions, type OnResolveResult, type OnRoleSelectMenuKitSubmit, type OnSelectMenuKitEnd, type OnSelectMenuKitSubmit, type OnStringSelectMenuKitSubmit, type OnUserSelectMenuKitSubmit, ParagraphInput, type ParsedCommandData, type ParsedEvent, type ParsedMessageCommand, type PluginTransformParameters, type PreRegisterCommandsEvent, type PreparedAppCommandExecution, type ResolvableCommand, type ResolveBuilderInteraction, type ResolveKind, type ResolveResult, RoleSelectMenu, RoleSelectMenuKit, type RoleSelectMenuKitPredicate, type RoleSelectMenuProps, type RunCommand, RuntimePlugin, type SelectMenuKitPredicate, type SelectMenuProps, type Setup, ShortInput, type SlashCommand, type SlashCommandContext, type SlashCommandMiddlewareContext, StringSelectMenu, StringSelectMenuKit, type StringSelectMenuKitPredicate, StringSelectMenuOption, type StringSelectMenuOptionProps, type StringSelectMenuProps, TextInput, type TextInputProps, type TransformedResult, type UserContextMenuCommand, type UserContextMenuCommandContext, type UserContextMenuCommandMiddlewareContext, UserSelectMenu, UserSelectMenuKit, type UserSelectMenuKitPredicate, type UserSelectMenuProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, commandkit, createElement, createLogger, debounce, CommandKit as default, defineConfig, devOnly, exitContext, exitMiddleware, fromEsbuildPlugin, getCommandKit, getConfig, getContext, getCurrentDirectory, getElement, getSourceDirectories, invalidate, isCachedFunction, isCommandKitElement, isCompilerPlugin, isInteractionSource, isMessageSource, isRuntimePlugin, makeContextAwareFunction, provideContext, redirect, rethrow, revalidate, useEnvironment, version, zzz_commandkit_secret_internal_use_cache_wrapper_do_not_use_or_you_will_be_fired };
+export { ActionRow, type ActionRowProps, type AnyCommandExecute, type AnyCommandKitElement, AppCommandHandler, type AsyncFunction, type AutocompleteCommand, type AutocompleteCommandContext, type AutocompleteCommandMiddlewareContext, type BootstrapFunction, Button, type ButtonChildrenLike, ButtonKit, type ButtonKitPredicate, type ButtonProps, COMMANDKIT_BOOTSTRAP_MODE, COMMANDKIT_CACHE_TAG, COMMANDKIT_IS_DEV, COMMANDKIT_IS_TEST, type CacheContext, type CacheEntry, type CacheMetadata, CacheProvider, ChannelSelectMenu, ChannelSelectMenuKit, type ChannelSelectMenuKitPredicate, type ChannelSelectMenuProps, type Command, type CommandBuilderLike, type CommandContext, type CommandContextOptions, type CommandData, CommandExecutionMode, CommandKit, type CommandKitButtonBuilderInteractionCollectorDispatch, type CommandKitButtonBuilderInteractionCollectorDispatchContextData, type CommandKitButtonBuilderOnEnd, type CommandKitConfiguration, type CommandKitElement, type CommandKitElementData, CommandKitEnvironment, type CommandKitEnvironmentInternalData, CommandKitEnvironmentType, type CommandKitHMREvent, type CommandKitLoggerOptions, type CommandKitModalBuilderInteractionCollectorDispatch, type CommandKitModalBuilderInteractionCollectorDispatchContextData, type CommandKitModalBuilderOnEnd, type CommandKitOptions, type CommandKitPlugin, CommandKitPluginRuntime, type CommandKitSelectMenuBuilderInteractionCollectorDispatch, type CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, type CommandKitSelectMenuBuilderOnEnd, CommandRegistrar, type CommandSource, type CommandTypeData, CommandsRouter, type CommandsRouterOptions, type CommonBuilderKit, type CommonPluginRuntime, type CommonSelectMenuProps, CompilerPlugin, CompilerPluginRuntime, Context, type ContextParameters, DefaultLogger, ElementType, EventInterceptor, type EventInterceptorContextData, type EventInterceptorErrorHandler, EventsRouter, type EventsRouterOptions, type EventsTree, Fragment, type FragmentElementProps, type GenericFunction, HMREventType, type ILogger, type InteractionCommandContext, type InteractionCommandMiddlewareContext, type LoadedCommand, type Loader, type Location, Logger, type LoggerImpl, type MaybeArray, type MaybeFalsey, MemoryCache, MentionableSelectMenu, MentionableSelectMenuKit, type MentionableSelectMenuKitPredicate, type MentionableSelectMenuProps, type Message, type MessageCommand, type MessageCommandContext, type MessageCommandMiddlewareContext, MessageCommandOptions, type MessageCommandOptionsSchema, MessageCommandParser, type MessageContextMenuCommand, type MessageContextMenuCommandContext, type MessageContextMenuCommandMiddlewareContext, type Middleware, MiddlewareContext, type MiddlewareContextArgs, Modal, ModalKit, type ModalKitPredicate, type ModalProps, type OnButtonKitClick, type OnButtonKitEnd, type OnChannelSelectMenuKitSubmit, type OnLoadArgs, type OnLoadOptions, type OnLoadResult, type OnMentionableSelectMenuKitSubmit, type OnModalKitEnd, type OnModalKitSubmit, type OnResolveArgs, type OnResolveOptions, type OnResolveResult, type OnRoleSelectMenuKitSubmit, type OnSelectMenuKitEnd, type OnSelectMenuKitSubmit, type OnStringSelectMenuKitSubmit, type OnUserSelectMenuKitSubmit, ParagraphInput, type ParsedCommandData, type ParsedEvent, type ParsedMessageCommand, type PluginTransformParameters, type PreRegisterCommandsEvent, type PreparedAppCommandExecution, type ResolvableCommand, type ResolveBuilderInteraction, type ResolveKind, type ResolveResult, RoleSelectMenu, RoleSelectMenuKit, type RoleSelectMenuKitPredicate, type RoleSelectMenuProps, type RunCommand, RuntimePlugin, type SelectMenuKitPredicate, type SelectMenuProps, type Setup, ShortInput, type SlashCommand, type SlashCommandContext, type SlashCommandMiddlewareContext, StringSelectMenu, StringSelectMenuKit, type StringSelectMenuKitPredicate, StringSelectMenuOption, type StringSelectMenuOptionProps, type StringSelectMenuProps, TextInput, type TextInputProps, type TransformedResult, type UserContextMenuCommand, type UserContextMenuCommandContext, type UserContextMenuCommandMiddlewareContext, UserSelectMenu, UserSelectMenuKit, type UserSelectMenuKitPredicate, type UserSelectMenuProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, commandkit, createElement, createLogger, debounce, CommandKit as default, defineConfig, devOnly, exitContext, exitMiddleware, fromEsbuildPlugin, getCommandKit, getConfig, getContext, getCurrentDirectory, getElement, getSourceDirectories, invalidate, isCachedFunction, isCommandKitElement, isCompilerPlugin, isInteractionSource, isMessageSource, isRuntimePlugin, makeContextAwareFunction, onApplicationBootstrap, onBootstrap, provideContext, redirect, rethrow, revalidate, useEnvironment, version, zzz_commandkit_secret_internal_use_cache_wrapper_do_not_use_or_you_will_be_fired };

package/dist/index.js

@@ -4249,9 +4249,9 @@ var init_AppCommandRunner = __esm({
 });
 
 // src/utils/types-package.ts
-async function generateTypesPackage() {
+async function generateTypesPackage(force = false) {
   const location = (0, import_node_path2.join)(process.cwd(), "node_modules", "commandkit-types");
-  if (!COMMANDKIT_IS_DEV) return location;
+  if (!COMMANDKIT_IS_DEV && !force) return location;
   const packageJSON = (0, import_node_path2.join)(location, "package.json");
   const index = (0, import_node_path2.join)(location, "index.js");
   const types = (0, import_node_path2.join)(location, "index.d.ts");
@@ -5095,12 +5095,52 @@ async function ensureTypeScript(target) {
   await loadTypeScript();
   return true;
 }
+function detectPackageManager() {
+  if (packageManager) return packageManager;
+  const lockfiles = {
+    "yarn.lock": "yarn",
+    "pnpm-lock.yaml": "pnpm",
+    "package-lock.json": "npm",
+    "bun.lock": "bun",
+    "bun.lockb": "bun"
+  };
+  for (const [lockfile, manager] of Object.entries(lockfiles)) {
+    if (import_node_fs5.default.existsSync((0, import_node_path5.join)(process.cwd(), lockfile))) {
+      packageManager = manager;
+      break;
+    }
+  }
+  if (!packageManager) {
+    packageManager = "npm";
+  }
+  return packageManager;
+}
 async function loadTypeScript(e) {
   if (ts) return ts;
   try {
     ts = await import("typescript");
-  } catch {
-    panic(e || "TypeScript must be installed to use TypeScript config files.");
+  } catch (e2) {
+    if (e2 instanceof Error && "code" in e2 && e2.code === "MODULE_NOT_FOUND") {
+      try {
+        const packageManager2 = detectPackageManager();
+        (0, import_node_child_process.execSync)(`${packageManager2} add typescript`, {
+          stdio: "inherit",
+          cwd: process.cwd()
+        });
+        console.log(
+          colors_default.cyan(
+            `TypeScript has been installed automatically, restarting...`
+          )
+        );
+        ts = await import("typescript");
+        return ts;
+      } catch {
+        panic(
+          "TypeScript is not installed and could not be installed automatically. Please install it manually."
+        );
+      }
+    }
+    panic(e2 || "TypeScript must be installed to use TypeScript config files.");
   }
   return ts;
 }
@@ -5154,7 +5194,7 @@ async function copyLocaleFiles(_from, _to) {
     });
   }
 }
-var import_rimraf, import_node_path5, import_node_fs5, ts;
+var import_rimraf, import_node_path5, import_node_fs5, import_node_child_process, ts, packageManager;
 var init_common2 = __esm({
   "src/cli/common.ts"() {
     "use strict";
@@ -5164,9 +5204,11 @@ var init_common2 = __esm({
     import_node_fs5 = __toESM(require("fs"));
     init_colors();
     init_types_package();
+    import_node_child_process = require("child_process");
     __name(write, "write");
     __name(panic, "panic");
     __name(ensureTypeScript, "ensureTypeScript");
+    __name(detectPackageManager, "detectPackageManager");
     __name(loadTypeScript, "loadTypeScript");
     __name(loadConfigFileFromPath, "loadConfigFileFromPath");
     __name(ensureExists, "ensureExists");
@@ -5331,7 +5373,13 @@ var init_CommandKitEventsChannel = __esm({
 });
 
 // src/CommandKit.ts
-var import_node_events2, import_discord19, import_node_path7, import_node_fs7, commandkit, _started, _CommandKit_instances, init_fn, initCommands_fn, initEvents_fn, _CommandKit, CommandKit;
+function onBootstrap(fn) {
+  bootstrapHooks.add(fn);
+}
+function onApplicationBootstrap(fn) {
+  onApplicationBootstrapHooks.add(fn);
+}
+var import_node_events2, import_discord19, import_node_path7, import_node_fs7, commandkit, bootstrapHooks, onApplicationBootstrapHooks, _started, _CommandKit_instances, bootstrapHooks_fn, applicationBootstrapHooks_fn, init_fn, initCommands_fn, initEvents_fn, _CommandKit, CommandKit;
 var init_CommandKit = __esm({
   "src/CommandKit.ts"() {
     "use strict";
@@ -5357,6 +5405,10 @@ var init_CommandKit = __esm({
     init_plugins();
     init_types_package();
     init_Logger();
+    bootstrapHooks = /* @__PURE__ */ new Set();
+    onApplicationBootstrapHooks = /* @__PURE__ */ new Set();
+    __name(onBootstrap, "onBootstrap");
+    __name(onApplicationBootstrap, "onApplicationBootstrap");
     _CommandKit = class _CommandKit extends import_node_events2.default {
       /**
        * Create a new command and event handler with CommandKit.
@@ -5401,6 +5453,7 @@ var init_CommandKit = __esm({
           _CommandKit.instance = this;
         }
         commandkit = _CommandKit.instance;
+        __privateMethod(this, _CommandKit_instances, bootstrapHooks_fn).call(this);
       }
       /**
        * Starts the commandkit application.
@@ -5447,6 +5500,7 @@ var init_CommandKit = __esm({
           await this.commandHandler.registrar.register();
         }
         __privateSet(this, _started, true);
+        await __privateMethod(this, _CommandKit_instances, applicationBootstrapHooks_fn).call(this);
       }
       /**
        * Loads all the plugins.
@@ -5559,6 +5613,30 @@ var init_CommandKit = __esm({
     };
     _started = new WeakMap();
     _CommandKit_instances = new WeakSet();
+    bootstrapHooks_fn = /* @__PURE__ */ __name(async function() {
+      for (const hook of bootstrapHooks) {
+        try {
+          await hook(this);
+        } catch (e) {
+          Logger.error("Error while executing bootstrap hook: ", e);
+        } finally {
+          bootstrapHooks.delete(hook);
+        }
+      }
+      bootstrapHooks.clear();
+    }, "#bootstrapHooks");
+    applicationBootstrapHooks_fn = /* @__PURE__ */ __name(async function() {
+      for (const hook of onApplicationBootstrapHooks) {
+        try {
+          await hook(this);
+        } catch (e) {
+          Logger.error("Error while executing application bootstrap hook: ", e);
+        } finally {
+          onApplicationBootstrapHooks.delete(hook);
+        }
+      }
+      onApplicationBootstrapHooks.clear();
+    }, "#applicationBootstrapHooks");
     init_fn = /* @__PURE__ */ __name(async function() {
       const appDir2 = this.getAppDirectory();
       if (!appDir2) return;
@@ -5617,7 +5695,7 @@ var init_version = __esm({
     "use strict";
     init_cjs_shims();
     version = /* @__MACRO__ $version */
-    "0.1.11-dev.20250406081911";
+    "0.1.11-dev.20250407135241";
   }
 });
 
@@ -5663,7 +5741,7 @@ function createAppProcess(fileName, cwd, isDev) {
     panic(`Could not locate the entrypoint file: ${fileName}`);
   }
   const stdio = getStdio(isDev);
-  const ps = (0, import_node_child_process.spawn)(
+  const ps = (0, import_node_child_process2.spawn)(
     "node",
     [
       `--title="CommandKit ${isDev ? "Development" : "Production"}"`,
@@ -5681,12 +5759,12 @@ function createAppProcess(fileName, cwd, isDev) {
   (_b = ps.stderr) == null ? void 0 : _b.pipe(process.stderr);
   return ps;
 }
-var import_node_child_process, import_node_path8, import_node_fs8;
+var import_node_child_process2, import_node_path8, import_node_fs8;
 var init_app_process = __esm({
   "src/cli/app-process.ts"() {
     "use strict";
     init_cjs_shims();
-    import_node_child_process = require("child_process");
+    import_node_child_process2 = require("child_process");
     init_env();
     import_node_path8 = require("path");
     import_node_fs8 = require("fs");
@@ -6401,7 +6479,7 @@ function findPackageVersion(packageName) {
 }
 function getBinaryVersion(binary) {
   try {
-    const version2 = (0, import_node_child_process2.execSync)(`${binary} --version`).toString().trim();
+    const version2 = (0, import_node_child_process3.execSync)(`${binary} --version`).toString().trim();
     return version2;
   } catch {
     return null;
@@ -6469,13 +6547,13 @@ async function showInformation() {
   }
   console.log(output.trim());
 }
-var import_node_os, import_node_child_process2, import_node_fs10, import_node_path11;
+var import_node_os, import_node_child_process3, import_node_fs10, import_node_path11;
 var init_information = __esm({
   "src/cli/information.ts"() {
     "use strict";
     init_cjs_shims();
     import_node_os = __toESM(require("os"));
-    import_node_child_process2 = require("child_process");
+    import_node_child_process3 = require("child_process");
     init_version();
     import_node_fs10 = __toESM(require("fs"));
     import_node_path11 = __toESM(require("path"));
@@ -6565,6 +6643,8 @@ __export(index_exports, {
   isMessageSource: () => isMessageSource,
   isRuntimePlugin: () => isRuntimePlugin,
   makeContextAwareFunction: () => makeContextAwareFunction,
+  onApplicationBootstrap: () => onApplicationBootstrap,
+  onBootstrap: () => onBootstrap,
   provideContext: () => provideContext,
   redirect: () => redirect,
   rethrow: () => rethrow,
@@ -6622,6 +6702,7 @@ init_cjs_shims();
 var import_node_fs11 = require("fs");
 var import_promises8 = require("fs/promises");
 var import_node_path12 = require("path");
+init_types_package();
 async function bootstrapCommandkitCLI(argv, options) {
   process.title = "CommandKit CLI";
   const { Command } = await import("commander");
@@ -6663,12 +6744,14 @@ async function bootstrapCommandkitCLI(argv, options) {
       console.error("Please specify what to create: --command or --event");
     }
   });
-  await program.parseAsync(argv, options);
   const types = (0, import_node_path12.join)(process.cwd(), "node_modules", "commandkit-types");
   if (!(0, import_node_fs11.existsSync)(types)) {
     await (0, import_promises8.mkdir)(types, { recursive: true }).catch(() => {
     });
+    await generateTypesPackage(true).catch(() => {
+    });
   }
+  await program.parseAsync(argv, options);
 }
 __name(bootstrapCommandkitCLI, "bootstrapCommandkitCLI");
 
@@ -6752,6 +6835,8 @@ var index_default = CommandKit;
   isMessageSource,
   isRuntimePlugin,
   makeContextAwareFunction,
+  onApplicationBootstrap,
+  onBootstrap,
   provideContext,
   redirect,
   rethrow,