commandkit 1.2.0-rc.9 → 1.2.1

package/dist/utils/{warn-unstable.d.ts → warning.d.ts}

@@ -1,4 +1,4 @@
-//#region src/utils/warn-unstable.d.ts
+//#region src/utils/warning.d.ts
 /**
  * Emit a warning message to the console as a CommandKitWarning.
  * @param message - The warning message to emit.
@@ -11,6 +11,15 @@ declare function emitWarning(message: string, code?: string): void;
  * @example warnUnstable('MyUnstableFeature');
  */
 declare function warnUnstable(name: string): void;
+declare function warnDeprecated({
+  what,
+  message,
+  where
+}: {
+  what: string;
+  where?: string;
+  message?: string;
+}): void;
 //#endregion
-export { emitWarning, warnUnstable };
-//# sourceMappingURL=warn-unstable.d.ts.map
+export { emitWarning, warnDeprecated, warnUnstable };
+//# sourceMappingURL=warning.d.ts.map

package/dist/utils/{warn-unstable.js → warning.js}

@@ -1,6 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-//#region src/utils/warn-unstable.ts
+//#region src/utils/warning.ts
 const WARNED_KEYS = /* @__PURE__ */ new Set();
+const DEPRECATED_KEYS = /* @__PURE__ */ new Set();
 /**
 * Emit a warning message to the console as a CommandKitWarning.
 * @param message - The warning message to emit.
@@ -19,8 +21,19 @@ function warnUnstable(name) {
 	WARNED_KEYS.add(name);
 	emitWarning(`${name} is unstable and may change in future versions.`, "CommandKitUnstableWarning");
 }
+function warnDeprecated({ what, message, where }) {
+	const name = `${what}:${where}`;
+	if (DEPRECATED_KEYS.has(name)) return;
+	DEPRECATED_KEYS.add(name);
+	emitWarning([
+		`${what} is deprecated`,
+		where ? `in ${where}` : "",
+		message || "and may be removed in future versions."
+	].filter(Boolean).join(" "), "CommandKitDeprecatedWarning");
+}
 
 //#endregion
 exports.emitWarning = emitWarning;
+exports.warnDeprecated = warnDeprecated;
 exports.warnUnstable = warnUnstable;
-//# sourceMappingURL=warn-unstable.js.map
+//# sourceMappingURL=warning.js.map

package/dist/utils/warning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warning.js","names":[],"sources":["../../src/utils/warning.ts"],"sourcesContent":["const WARNED_KEYS = new Set<string>();\nconst DEPRECATED_KEYS = new Set<string>();\n\n/**\n * Emit a warning message to the console as a CommandKitWarning.\n * @param message - The warning message to emit.\n * @param code - The warning code (default is 'CommandKitWarning').\n */\nexport function emitWarning(message: string, code = 'CommandKitWarning') {\n  process.emitWarning(message, { code });\n}\n\n/**\n * Emit a warning for unstable features in CommandKit.\n * @param name - The name of the unstable feature.\n * @example warnUnstable('MyUnstableFeature');\n */\nexport function warnUnstable(name: string) {\n  if (WARNED_KEYS.has(name)) return;\n\n  WARNED_KEYS.add(name);\n\n  emitWarning(\n    `${name} is unstable and may change in future versions.`,\n    'CommandKitUnstableWarning',\n  );\n}\nexport function warnDeprecated({\n  what,\n  message,\n  where,\n}: {\n  what: string;\n  where?: string;\n  message?: string;\n}) {\n  const name = `${what}:${where}`;\n\n  if (DEPRECATED_KEYS.has(name)) return;\n\n  DEPRECATED_KEYS.add(name);\n\n  emitWarning(\n    [\n      `${what} is deprecated`,\n      where ? `in ${where}` : '',\n      message || 'and may be removed in future versions.',\n    ]\n      .filter(Boolean)\n      .join(' '),\n    'CommandKitDeprecatedWarning',\n  );\n}\n"],"mappings":";;;AAAA,MAAM,8BAAc,IAAI,KAAa;AACrC,MAAM,kCAAkB,IAAI,KAAa;;;;;;AAOzC,SAAgB,YAAY,SAAiB,OAAO,qBAAqB;AACvE,SAAQ,YAAY,SAAS,EAAE,MAAM,CAAC;;;;;;;AAQxC,SAAgB,aAAa,MAAc;AACzC,KAAI,YAAY,IAAI,KAAK,CAAE;AAE3B,aAAY,IAAI,KAAK;AAErB,aACE,GAAG,KAAK,kDACR,4BACD;;AAEH,SAAgB,eAAe,EAC7B,MACA,SACA,SAKC;CACD,MAAM,OAAO,GAAG,KAAK,GAAG;AAExB,KAAI,gBAAgB,IAAI,KAAK,CAAE;AAE/B,iBAAgB,IAAI,KAAK;AAEzB,aACE;EACA,GAAG,KAAE;EACL,QAAQ,MAAM,UAAU;EACxB,WAAW;EAAyC,CAEpD,OAAG,QAAO,CACV,KAAG,IAAM,EACT,8BACD"}

package/dist/version.d.ts

@@ -1,2 +1,8 @@
-import { version } from "./version-CtJtBJXI.js";
-export { version };
+//#region src/version.d.ts
+/**
+ * The current version of CommandKit.
+ */
+declare const version: string;
+//#endregion
+export { version };
+//# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,14 @@
-const require_version = require('./version-DRSQMx0w.js');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-exports.version = require_version.version;
+//#region src/version.ts
+/**
+* @private
+*/
+/**
+* The current version of CommandKit.
+*/
+const version = "1.2.1";
+
+//#endregion
+exports.version = version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["/**\n * @private\n */\nfunction $version(): string {\n  'use macro';\n  return require('../package.json').version;\n}\n\n/**\n * The current version of CommandKit.\n */\nexport const version: string = $version();\n"],"mappings":";;;;;;;;;AAWA,MAAa,UAA4B"}

package/hooks.cjs

@@ -9,11 +9,18 @@ const {
 } = require('./dist/app/events/EventWorkerContext.js');
 
 function useAnyEnvironment() {
-  const commandCtx = getContext();
-  if (commandCtx) return commandCtx;
+  try {
+    const commandCtx = getContext();
+    if (commandCtx) return commandCtx;
+  } catch {}
+
+  try {
+    const eventWorkerCtx = getEventWorkerContext();
+    if (eventWorkerCtx) return eventWorkerCtx;
+  } catch {}
 
-  const eventWorkerCtx = getEventWorkerContext();
-  if (eventWorkerCtx) return eventWorkerCtx;
+  const maybeCommandKit = getCommandKit();
+  if (maybeCommandKit) return { commandkit: maybeCommandKit };
 
   throw new Error(
     'No environment found. This hook must be used within a CommandKit environment.',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "commandkit",
   "description": "Beginner friendly command & event handler for Discord.js",
-  "version": "1.2.0-rc.9",
+  "version": "1.2.1",
   "license": "MIT",
   "type": "commonjs",
   "main": "./dist/index.js",
@@ -46,7 +46,9 @@
     "./mutex.cjs",
     "./mutex.d.ts",
     "./kv.cjs",
-    "./kv.d.ts"
+    "./kv.d.ts",
+    "./cli.cjs",
+    "./cli.d.ts"
   ],
   "exports": {
     ".": {
@@ -143,11 +145,16 @@
       "require": "./semaphore.cjs",
       "import": "./semaphore.cjs",
       "types": "./semaphore.d.ts"
+    },
+    "./cli": {
+      "require": "./cli.cjs",
+      "import": "./cli.cjs",
+      "types": "./cli.d.ts"
     }
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/underctrl-io/commandkit",
+    "url": "https://github.com/neplextech/commandkit",
     "directory": "packages/commandkit"
   },
   "homepage": "https://commandkit.dev",
@@ -161,26 +168,23 @@
   "dependencies": {
     "@rollup/plugin-json": "^6.1.0",
     "chokidar": "^4.0.3",
-    "commander": "^13.0.0",
-    "directive-to-hof": "^0.0.2",
-    "dotenv": "^16.4.7",
+    "commander": "^14.0.3",
+    "directive-to-hof": "^0.0.3",
     "ms": "^2.1.3",
-    "ora": "^8.0.1",
+    "ora": "^9.3.0",
     "picocolors": "^1.1.1",
-    "rfdc": "^1.3.1",
-    "rimraf": "^6.0.0",
-    "tsdown": "^0.14.2",
+    "rimraf": "^6.1.3",
+    "tsdown": "^0.21.0-beta.2",
     "use-macro": "^1.1.0"
   },
   "devDependencies": {
-    "@types/ms": "^2.0.0",
-    "@types/node": "^22.10.2",
-    "@types/yargs": "^17.0.32",
-    "discord.js": "^14.22.1",
-    "tsx": "^4.19.2",
-    "typescript": "^5.7.3",
-    "vitest": "^3.0.5",
-    "tsconfig": "0.0.0-rc.9"
+    "@types/ms": "^2.1.0",
+    "@types/node": "^25.3.2",
+    "discord.js": "^14.25.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "tsconfig": "1.2.1"
   },
   "engines": {
     "node": ">=24"

package/ratelimit.cjs

@@ -18,7 +18,6 @@ module.exports = {
   getRemainingRequests,
   getResetTime,
   resetRateLimit,
-  RateLimitStorage,
   DEFAULT_MAX_REQUESTS,
   DEFAULT_TIMEOUT,
   MemoryRateLimitStorage,

package/dist/ActionRow-CbdGFWMT.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ActionRow-CbdGFWMT.js","names":[],"sources":["../src/components/v1/action-row/ActionRow.ts"],"sourcesContent":["import { ActionRowBuilder } from 'discord.js';\nimport { AnyCommandKitElement, CommandKitElement } from '../../common/element';\n\n/**\n * The properties for the action row component.\n */\nexport interface ActionRowProps {\n  children?: AnyCommandKitElement[] | AnyCommandKitElement;\n}\n\n/**\n * The action row component.\n * @param props The action row properties.\n * @returns The commandkit element.\n * @example <ActionRow><Button label=\"Click me\" style={ButtonStyle.Primary} customId=\"click_me\" /></ActionRow>\n */\nexport function ActionRow(\n  props: ActionRowProps,\n): CommandKitElement<'action-row'> {\n  const row = new ActionRowBuilder();\n\n  if (Array.isArray(props.children)) {\n    // @ts-ignore\n    row.setComponents(...props.children);\n  } else if (props.children) {\n    // @ts-ignore\n    row.setComponents(props.children);\n  }\n\n  return row;\n}\n"],"mappings":";;;;;;;;;;;AAgBA,SAAgB,UAChB,OACkC;CAChC,MAAM,MAAM,IAAI,6BAAkB;AAElC,KAAI,MAAM,QAAQ,MAAM,SAAS,CAE/B,KAAI,cAAc,GAAG,MAAM,SAAS;UAC3B,MAAM,SAEf,KAAI,cAAc,MAAM,SAAS;AAGnC,QAAO"}

package/dist/CommandKitEventsChannel-BtRzr3Tz.js

@@ -1,88 +0,0 @@
-const require_chunk = require('./chunk-nOFOJqeH.js');
-let node_events = require("node:events");
-node_events = require_chunk.__toESM(node_events);
-
-//#region src/events/CommandKitEventsChannel.ts
-/**
-* Represents a channel for emitting and listening to events in CommandKit.
-* This class provides methods to manage event listeners and emit events
-* within a specific namespace.
-*/
-var CommandKitEventsChannel = class {
-	emitter = new node_events.default();
-	/**
-	* Creates a new instance of CommandKitEventsChannel.
-	* @param commandkit The CommandKit instance that this channel belongs to.
-	*/
-	constructor(commandkit) {
-		this.commandkit = commandkit;
-	}
-	/**
-	* Creates a namespaced event channel. This allows you to manage events
-	* within a specific namespace, preventing conflicts with other event channels.
-	* This is useful for organizing events related to different parts of your application.
-	* @param namespace The namespace for the event channel.
-	* @returns An object containing methods for managing events within the namespace.
-	* @example commandkit.events.to('customNamespace').emit('eventName', data);
-	*/
-	to(namespace) {
-		return {
-			on: this.on.bind(this, namespace),
-			off: this.off.bind(this, namespace),
-			once: this.once.bind(this, namespace),
-			emit: this.emit.bind(this, namespace),
-			removeAllListeners: this.removeAllListeners.bind(this, namespace)
-		};
-	}
-	/**
-	* Register an event listener for a specific event within the namespace.
-	* @param namespace The namespace for the event channel.
-	* @param event The name of the event to listen for.
-	* @param listener The function to call when the event is emitted.
-	*/
-	on(namespace, event, listener) {
-		this.emitter.on(`${namespace}:${event}`, listener);
-	}
-	/**
-	* Unregister an event listener for a specific event within the namespace.
-	* @param namespace The namespace for the event channel.
-	* @param event The name of the event to stop listening for.
-	* @param listener The function that was registered as the listener.
-	*/
-	off(namespace, event, listener) {
-		this.emitter.off(`${namespace}:${event}`, listener);
-	}
-	/**
-	* Register an event listener that will be called only once for a specific event
-	* within the namespace.
-	* @param namespace The namespace for the event channel.
-	* @param event The name of the event to listen for.
-	* @param listener The function to call when the event is emitted.
-	*/
-	once(namespace, event, listener) {
-		this.emitter.once(`${namespace}:${event}`, listener);
-	}
-	/**
-	* Emit an event within the specified namespace, calling all registered listeners.
-	* @param namespace The namespace for the event channel.
-	* @param event The name of the event to emit.
-	* @param args The arguments to pass to the listeners.
-	* @returns A boolean indicating whether any listeners were called.
-	*/
-	emit(namespace, event, ...args) {
-		return this.emitter.emit(`${namespace}:${event}`, ...args);
-	}
-	removeAllListeners(namespace, event) {
-		if (event) this.emitter.removeAllListeners(`${namespace}:${event}`);
-		else this.emitter.removeAllListeners(namespace);
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'CommandKitEventsChannel', {
-  enumerable: true,
-  get: function () {
-    return CommandKitEventsChannel;
-  }
-});
-//# sourceMappingURL=CommandKitEventsChannel-BtRzr3Tz.js.map

package/dist/CommandKitEventsChannel-BtRzr3Tz.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CommandKitEventsChannel-BtRzr3Tz.js","names":[],"sources":["../src/events/CommandKitEventsChannel.ts"],"sourcesContent":["import EventEmitter from 'node:events';\nimport type { CommandKit } from '../commandkit';\nimport type { AsyncFunction, GenericFunction } from '../context/async-context';\n\n/**\n * The function type for event listeners.\n */\nexport type ListenerFunction = GenericFunction | AsyncFunction;\n\n/**\n * Represents a channel for emitting and listening to events in CommandKit.\n * This class provides methods to manage event listeners and emit events\n * within a specific namespace.\n */\nexport class CommandKitEventsChannel {\n  private emitter = new EventEmitter();\n\n  /**\n   * Creates a new instance of CommandKitEventsChannel.\n   * @param commandkit The CommandKit instance that this channel belongs to.\n   */\n  public constructor(public readonly commandkit: CommandKit) {}\n\n  /**\n   * Creates a namespaced event channel. This allows you to manage events\n   * within a specific namespace, preventing conflicts with other event channels.\n   * This is useful for organizing events related to different parts of your application.\n   * @param namespace The namespace for the event channel.\n   * @returns An object containing methods for managing events within the namespace.\n   * @example commandkit.events.to('customNamespace').emit('eventName', data);\n   */\n  public to(namespace: string) {\n    return {\n      on: this.on.bind(this, namespace),\n      off: this.off.bind(this, namespace),\n      once: this.once.bind(this, namespace),\n      emit: this.emit.bind(this, namespace),\n      removeAllListeners: this.removeAllListeners.bind(this, namespace),\n    };\n  }\n\n  /**\n   * Register an event listener for a specific event within the namespace.\n   * @param namespace The namespace for the event channel.\n   * @param event The name of the event to listen for.\n   * @param listener The function to call when the event is emitted.\n   */\n  public on(namespace: string, event: string, listener: ListenerFunction) {\n    this.emitter.on(`${namespace}:${event}`, listener);\n  }\n\n  /**\n   * Unregister an event listener for a specific event within the namespace.\n   * @param namespace The namespace for the event channel.\n   * @param event The name of the event to stop listening for.\n   * @param listener The function that was registered as the listener.\n   */\n  public off(namespace: string, event: string, listener: ListenerFunction) {\n    this.emitter.off(`${namespace}:${event}`, listener);\n  }\n\n  /**\n   * Register an event listener that will be called only once for a specific event\n   * within the namespace.\n   * @param namespace The namespace for the event channel.\n   * @param event The name of the event to listen for.\n   * @param listener The function to call when the event is emitted.\n   */\n  public once(namespace: string, event: string, listener: ListenerFunction) {\n    this.emitter.once(`${namespace}:${event}`, listener);\n  }\n\n  /**\n   * Emit an event within the specified namespace, calling all registered listeners.\n   * @param namespace The namespace for the event channel.\n   * @param event The name of the event to emit.\n   * @param args The arguments to pass to the listeners.\n   * @returns A boolean indicating whether any listeners were called.\n   */\n  public emit(namespace: string, event: string, ...args: any[]) {\n    return this.emitter.emit(`${namespace}:${event}`, ...args);\n  }\n\n  /**\n   * Remove all listeners for a specific event or all events within the namespace.\n   * @param namespace The namespace for the event channel.\n   * @param event The name of the event to remove listeners for. If not provided, all listeners for all events in the namespace will be removed.\n   */\n  public removeAllListeners(namespace: string): void;\n  public removeAllListeners(namespace: string, event: string): void;\n  public removeAllListeners(namespace: string, event?: string): void {\n    if (event) {\n      this.emitter.removeAllListeners(`${namespace}:${event}`);\n    } else {\n      this.emitter.removeAllListeners(namespace);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;AAcA,IAAa,0BAAb,MAAqC;CACnC,AAAQ,UAAU,IAAI,qBAAc;;;;;CAMpC,AAAO,YAAY,AAAgB,YAAwB;EAAxB;;;;;;;;;;CAUnC,AAAO,GAAG,WAAmB;AAC3B,SAAO;GACL,IAAI,KAAK,GAAG,KAAK,MAAM,UAAU;GACjC,KAAK,KAAK,IAAI,KAAK,MAAM,UAAU;GACnC,MAAM,KAAK,KAAK,KAAK,MAAM,UAAU;GACrC,MAAM,KAAK,KAAK,KAAK,MAAM,UAAU;GACrC,oBAAoB,KAAK,mBAAmB,KAAK,MAAM,UAAU;GAClE;;;;;;;;CASH,AAAO,GAAG,WAAmB,OAAe,UAA4B;AACtE,OAAK,QAAQ,GAAG,GAAG,UAAU,GAAG,SAAS,SAAS;;;;;;;;CASpD,AAAO,IAAI,WAAmB,OAAe,UAA4B;AACvE,OAAK,QAAQ,IAAI,GAAG,UAAU,GAAG,SAAS,SAAS;;;;;;;;;CAUrD,AAAO,KAAK,WAAmB,OAAe,UAA4B;AACxE,OAAK,QAAQ,KAAK,GAAG,UAAU,GAAG,SAAS,SAAS;;;;;;;;;CAUtD,AAAO,KAAK,WAAmB,OAAe,GAAG,MAAa;AAC5D,SAAO,KAAK,QAAQ,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK;;CAU5D,AAAO,mBAAmB,WAAmB,OAAsB;AACjE,MAAI,MACF,MAAK,QAAQ,mBAAmB,GAAG,UAAU,GAAG,QAAQ;MAExD,MAAK,QAAQ,mBAAmB,UAAU"}

package/dist/CommandsRouter-Cgcy6cK9.js

@@ -1,220 +0,0 @@
-const require_chunk = require('./chunk-nOFOJqeH.js');
-let discord_js = require("discord.js");
-discord_js = require_chunk.__toESM(discord_js);
-let node_fs = require("node:fs");
-node_fs = require_chunk.__toESM(node_fs);
-let node_path = require("node:path");
-node_path = require_chunk.__toESM(node_path);
-let node_fs_promises = require("node:fs/promises");
-node_fs_promises = require_chunk.__toESM(node_fs_promises);
-
-//#region src/app/router/CommandsRouter.ts
-/**
-* @private
-* @internal
-*/
-const MIDDLEWARE_PATTERN = /^\+middleware\.(m|c)?(j|t)sx?$/;
-/**
-* @private
-* @internal
-*/
-const COMMAND_MIDDLEWARE_PATTERN = /^\+([^+().][^().]*)\.middleware\.(m|c)?(j|t)sx?$/;
-/**
-* @private
-* @internal
-*/
-const GLOBAL_MIDDLEWARE_PATTERN = /^\+global-middleware\.(m|c)?(j|t)sx?$/;
-/**
-* @private
-* @internal
-*/
-const COMMAND_PATTERN = /^([^+().][^().]*)\.(m|c)?(j|t)sx?$/;
-/**
-* @private
-* @internal
-*/
-const CATEGORY_PATTERN = /^\(.+\)$/;
-/**
-* Handles discovery and parsing of command and middleware files in the filesystem.
-*/
-var CommandsRouter = class {
-	/**
-	* @private
-	* @internal
-	*/
-	commands = new discord_js.Collection();
-	/**
-	* @private
-	* @internal
-	*/
-	middlewares = new discord_js.Collection();
-	/**
-	* Creates a new CommandsRouter instance.
-	* @param options - Configuration options for the router
-	*/
-	constructor(options) {
-		this.options = options;
-	}
-	/**
-	* Populates the router with existing command and middleware data.
-	* @param data - Parsed command data to populate with
-	*/
-	populate(data) {
-		for (const [id, command] of Object.entries(data.commands)) this.commands.set(id, command);
-		for (const [id, middleware] of Object.entries(data.middlewares)) this.middlewares.set(id, middleware);
-	}
-	/**
-	* Checks if the configured entrypoint path exists.
-	* @returns True if the path exists
-	*/
-	isValidPath() {
-		return (0, node_fs.existsSync)(this.options.entrypoint);
-	}
-	/**
-	* @private
-	* @internal
-	*/
-	isCommand(name) {
-		return COMMAND_PATTERN.test(name);
-	}
-	/**
-	* @private
-	* @internal
-	*/
-	isMiddleware(name) {
-		return MIDDLEWARE_PATTERN.test(name) || GLOBAL_MIDDLEWARE_PATTERN.test(name) || COMMAND_MIDDLEWARE_PATTERN.test(name);
-	}
-	/**
-	* @private
-	* @internal
-	*/
-	isCategory(name) {
-		return CATEGORY_PATTERN.test(name);
-	}
-	/**
-	* Clears all loaded commands and middleware.
-	*/
-	clear() {
-		this.commands.clear();
-		this.middlewares.clear();
-	}
-	/**
-	* Scans the filesystem for commands and middleware files.
-	* @returns Parsed command data
-	*/
-	async scan() {
-		const entries = await (0, node_fs_promises.readdir)(this.options.entrypoint, { withFileTypes: true });
-		for (const entry of entries) {
-			if (entry.name.startsWith("_")) continue;
-			const fullPath = (0, node_path.join)(this.options.entrypoint, entry.name);
-			if (entry.isDirectory()) {
-				const category = this.isCategory(entry.name) ? entry.name.slice(1, -1) : null;
-				await this.traverse(fullPath, category);
-			} else await this.handle(entry);
-		}
-		await this.applyMiddlewares();
-		return this.toJSON();
-	}
-	/**
-	* Gets the raw command and middleware collections.
-	* @returns Object containing commands and middlewares collections
-	*/
-	getData() {
-		return {
-			commands: this.commands,
-			middlewares: this.middlewares
-		};
-	}
-	/**
-	* Converts the loaded data to a JSON-serializable format.
-	* @returns Plain object with commands and middlewares
-	*/
-	toJSON() {
-		return {
-			commands: Object.fromEntries(this.commands.entries()),
-			middlewares: Object.fromEntries(this.middlewares.entries())
-		};
-	}
-	/**
-	* @private
-	* @internal
-	*/
-	async traverse(path, category) {
-		const entries = await (0, node_fs_promises.readdir)(path, { withFileTypes: true });
-		for (const entry of entries) {
-			if (entry.name.startsWith("_")) continue;
-			if (entry.isFile()) {
-				if (this.isCommand(entry.name) || this.isMiddleware(entry.name)) await this.handle(entry, category);
-			} else if (entry.isDirectory() && this.isCategory(entry.name) && category) {
-				const nestedCategory = this.isCategory(entry.name) ? `${category}:${entry.name.slice(1, -1)}` : null;
-				await this.traverse((0, node_path.join)(path, entry.name), nestedCategory);
-			}
-		}
-	}
-	/**
-	* @private
-	* @internal
-	*/
-	async handle(entry, category = null) {
-		const name = entry.name;
-		const path = (0, node_path.join)(entry.parentPath, entry.name);
-		if (this.isCommand(name)) {
-			const command = {
-				id: crypto.randomUUID(),
-				name: (0, node_path.basename)(path, (0, node_path.extname)(path)),
-				path,
-				category,
-				parentPath: entry.parentPath,
-				relativePath: this.replaceEntrypoint(path),
-				middlewares: []
-			};
-			this.commands.set(command.id, command);
-		} else if (this.isMiddleware(name)) {
-			var _name$match;
-			const middleware = {
-				id: crypto.randomUUID(),
-				name: (0, node_path.basename)(path, (0, node_path.extname)(path)),
-				path,
-				relativePath: this.replaceEntrypoint(path),
-				parentPath: entry.parentPath,
-				global: GLOBAL_MIDDLEWARE_PATTERN.test(name),
-				command: COMMAND_MIDDLEWARE_PATTERN.test(name) ? ((_name$match = name.match(COMMAND_MIDDLEWARE_PATTERN)) === null || _name$match === void 0 ? void 0 : _name$match[1]) || null : null
-			};
-			this.middlewares.set(middleware.id, middleware);
-		}
-	}
-	/**
-	* @private
-	* @internal
-	*/
-	applyMiddlewares() {
-		this.commands.forEach((command) => {
-			const commandPath = command.parentPath;
-			const allMiddlewares = Array.from(this.middlewares.values());
-			const commandSpecificMiddlewares = allMiddlewares.filter((middleware) => middleware.command === command.name).map((middleware) => middleware.id);
-			const directorySpecificMiddlewares = allMiddlewares.filter((middleware) => !middleware.global && !middleware.command && middleware.parentPath === commandPath).map((middleware) => middleware.id);
-			const globalMiddlewares = allMiddlewares.filter((middleware) => middleware.global).map((middleware) => middleware.id);
-			command.middlewares = [
-				...commandSpecificMiddlewares,
-				...directorySpecificMiddlewares,
-				...globalMiddlewares
-			];
-		});
-	}
-	/**
-	* @private
-	* @internal
-	*/
-	replaceEntrypoint(path) {
-		return (0, node_path.normalize)(path).replace(this.options.entrypoint, "");
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'CommandsRouter', {
-  enumerable: true,
-  get: function () {
-    return CommandsRouter;
-  }
-});
-//# sourceMappingURL=CommandsRouter-Cgcy6cK9.js.map

package/dist/CommandsRouter-Cgcy6cK9.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CommandsRouter-Cgcy6cK9.js","names":[],"sources":["../src/app/router/CommandsRouter.ts"],"sourcesContent":["import { Collection } from 'discord.js';\nimport { Dirent, existsSync } from 'node:fs';\nimport { readdir } from 'node:fs/promises';\nimport { basename, extname, join, normalize } from 'node:path';\n\n/**\n * Represents a command with its metadata and middleware associations.\n */\nexport interface Command {\n  id: string;\n  name: string;\n  path: string;\n  relativePath: string;\n  parentPath: string;\n  middlewares: Array<string>;\n  category: string | null;\n}\n\n/**\n * Represents a middleware with its metadata and scope.\n */\nexport interface Middleware {\n  id: string;\n  name: string;\n  path: string;\n  relativePath: string;\n  parentPath: string;\n  global: boolean;\n  command: string | null;\n}\n\n/**\n * Data structure containing parsed commands and middleware.\n */\nexport interface ParsedCommandData {\n  commands: Record<string, Command>;\n  middlewares: Record<string, Middleware>;\n}\n\n/**\n * Configuration options for the commands router.\n */\nexport interface CommandsRouterOptions {\n  entrypoint: string;\n}\n\n/**\n * @private\n * @internal\n */\nconst MIDDLEWARE_PATTERN = /^\\+middleware\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst COMMAND_MIDDLEWARE_PATTERN =\n  /^\\+([^+().][^().]*)\\.middleware\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst GLOBAL_MIDDLEWARE_PATTERN = /^\\+global-middleware\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst COMMAND_PATTERN = /^([^+().][^().]*)\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst CATEGORY_PATTERN = /^\\(.+\\)$/;\n\n/**\n * Handles discovery and parsing of command and middleware files in the filesystem.\n */\nexport class CommandsRouter {\n  /**\n   * @private\n   * @internal\n   */\n  private commands = new Collection<string, Command>();\n\n  /**\n   * @private\n   * @internal\n   */\n  private middlewares = new Collection<string, Middleware>();\n\n  /**\n   * Creates a new CommandsRouter instance.\n   * @param options - Configuration options for the router\n   */\n  public constructor(private readonly options: CommandsRouterOptions) {}\n\n  /**\n   * Populates the router with existing command and middleware data.\n   * @param data - Parsed command data to populate with\n   */\n  public populate(data: ParsedCommandData) {\n    for (const [id, command] of Object.entries(data.commands)) {\n      this.commands.set(id, command);\n    }\n\n    for (const [id, middleware] of Object.entries(data.middlewares)) {\n      this.middlewares.set(id, middleware);\n    }\n  }\n\n  /**\n   * Checks if the configured entrypoint path exists.\n   * @returns True if the path exists\n   */\n  public isValidPath(): boolean {\n    return existsSync(this.options.entrypoint);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isCommand(name: string): boolean {\n    return COMMAND_PATTERN.test(name);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isMiddleware(name: string): boolean {\n    return (\n      MIDDLEWARE_PATTERN.test(name) ||\n      GLOBAL_MIDDLEWARE_PATTERN.test(name) ||\n      COMMAND_MIDDLEWARE_PATTERN.test(name)\n    );\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isCategory(name: string): boolean {\n    return CATEGORY_PATTERN.test(name);\n  }\n\n  /**\n   * Clears all loaded commands and middleware.\n   */\n  public clear() {\n    this.commands.clear();\n    this.middlewares.clear();\n  }\n\n  /**\n   * Scans the filesystem for commands and middleware files.\n   * @returns Parsed command data\n   */\n  public async scan() {\n    const entries = await readdir(this.options.entrypoint, {\n      withFileTypes: true,\n    });\n\n    for (const entry of entries) {\n      // ignore _ prefixed files\n      if (entry.name.startsWith('_')) continue;\n\n      const fullPath = join(this.options.entrypoint, entry.name);\n\n      if (entry.isDirectory()) {\n        const category = this.isCategory(entry.name)\n          ? entry.name.slice(1, -1)\n          : null;\n\n        await this.traverse(fullPath, category);\n      } else {\n        await this.handle(entry);\n      }\n    }\n\n    await this.applyMiddlewares();\n\n    return this.toJSON();\n  }\n\n  /**\n   * Gets the raw command and middleware collections.\n   * @returns Object containing commands and middlewares collections\n   */\n  public getData() {\n    return {\n      commands: this.commands,\n      middlewares: this.middlewares,\n    };\n  }\n\n  /**\n   * Converts the loaded data to a JSON-serializable format.\n   * @returns Plain object with commands and middlewares\n   */\n  public toJSON() {\n    return {\n      commands: Object.fromEntries(this.commands.entries()),\n      middlewares: Object.fromEntries(this.middlewares.entries()),\n    };\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private async traverse(path: string, category: string | null) {\n    const entries = await readdir(path, {\n      withFileTypes: true,\n    });\n\n    for (const entry of entries) {\n      // ignore _ prefixed files\n      if (entry.name.startsWith('_')) continue;\n\n      if (entry.isFile()) {\n        if (this.isCommand(entry.name) || this.isMiddleware(entry.name)) {\n          await this.handle(entry, category);\n        }\n      } else if (\n        entry.isDirectory() &&\n        this.isCategory(entry.name) &&\n        category\n      ) {\n        // nested category\n        const nestedCategory = this.isCategory(entry.name)\n          ? `${category}:${entry.name.slice(1, -1)}`\n          : null;\n        await this.traverse(join(path, entry.name), nestedCategory);\n      }\n\n      // TODO: handle subcommands\n    }\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private async handle(entry: Dirent, category: string | null = null) {\n    const name = entry.name;\n    const path = join(entry.parentPath, entry.name);\n\n    if (this.isCommand(name)) {\n      const command: Command = {\n        id: crypto.randomUUID(),\n        name: basename(path, extname(path)),\n        path,\n        category,\n        parentPath: entry.parentPath,\n        relativePath: this.replaceEntrypoint(path),\n        middlewares: [],\n      };\n\n      this.commands.set(command.id, command);\n    } else if (this.isMiddleware(name)) {\n      const middleware: Middleware = {\n        id: crypto.randomUUID(),\n        name: basename(path, extname(path)),\n        path,\n        relativePath: this.replaceEntrypoint(path),\n        parentPath: entry.parentPath,\n        global: GLOBAL_MIDDLEWARE_PATTERN.test(name),\n        command: COMMAND_MIDDLEWARE_PATTERN.test(name)\n          ? name.match(COMMAND_MIDDLEWARE_PATTERN)?.[1] || null\n          : null,\n      };\n\n      this.middlewares.set(middleware.id, middleware);\n    }\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private applyMiddlewares() {\n    this.commands.forEach((command) => {\n      const commandPath = command.parentPath;\n      const allMiddlewares = Array.from(this.middlewares.values());\n\n      const commandSpecificMiddlewares = allMiddlewares\n        .filter((middleware) => middleware.command === command.name)\n        .map((middleware) => middleware.id);\n\n      const directorySpecificMiddlewares = allMiddlewares\n        .filter(\n          (middleware) =>\n            !middleware.global &&\n            !middleware.command &&\n            middleware.parentPath === commandPath,\n        )\n        .map((middleware) => middleware.id);\n\n      const globalMiddlewares = allMiddlewares\n        .filter((middleware) => middleware.global)\n        .map((middleware) => middleware.id);\n\n      command.middlewares = [\n        ...commandSpecificMiddlewares,\n        ...directorySpecificMiddlewares,\n        ...globalMiddlewares,\n      ];\n    });\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private replaceEntrypoint(path: string) {\n    const normalized = normalize(path);\n    return normalized.replace(this.options.entrypoint, '');\n  }\n}\n"],"mappings":"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"}

package/dist/CompilerPlugin-M8r3yNAl.js

@@ -1,43 +0,0 @@
-const require_PluginCommon = require('./PluginCommon-Cvl5yYM_.js');
-
-//#region src/plugins/CompilerPlugin.ts
-/**
-* CommandKit plugin that runs at compile time.
-*/
-var CompilerPlugin = class extends require_PluginCommon.PluginCommon {
-	/**
-	* The type of the plugin, which is Compiler.
-	*/
-	type = require_PluginCommon.PluginType.Compiler;
-	/**
-	* Called when transformation is requested to this plugin
-	* @param params The parameters for the transformation
-	* @returns The transformed result
-	*/
-	async transform(params) {
-		return null;
-	}
-};
-/**
-* Type guard to check if the given object is a CompilerPlugin.
-* @param plugin The object to check.
-* @returns Boolean indicating whether the object is a CompilerPlugin.
-*/
-function isCompilerPlugin(plugin) {
-	return plugin instanceof CompilerPlugin || require_PluginCommon.isPlugin(plugin) && plugin.type === require_PluginCommon.PluginType.Compiler;
-}
-
-//#endregion
-Object.defineProperty(exports, 'CompilerPlugin', {
-  enumerable: true,
-  get: function () {
-    return CompilerPlugin;
-  }
-});
-Object.defineProperty(exports, 'isCompilerPlugin', {
-  enumerable: true,
-  get: function () {
-    return isCompilerPlugin;
-  }
-});
-//# sourceMappingURL=CompilerPlugin-M8r3yNAl.js.map

package/dist/CompilerPlugin-M8r3yNAl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CompilerPlugin-M8r3yNAl.js","names":[],"sources":["../src/plugins/CompilerPlugin.ts"],"sourcesContent":["import {\n  isPlugin,\n  PluginCommon,\n  PluginOptions,\n  PluginType,\n} from './PluginCommon';\nimport { MaybeFalsey } from './types';\nimport { CompilerPluginRuntime } from './plugin-runtime/CompilerPluginRuntime';\n\n/**\n * The parameters for the transformation function of a compiler plugin.\n */\nexport interface PluginTransformParameters {\n  /**\n   * The code to be transformed.\n   */\n  code: string;\n  /**\n   * The filename of the code being transformed.\n   */\n  id: string;\n}\n\nexport interface TransformedResult {\n  /**\n   * The transformed code.\n   */\n  code?: string;\n  /**\n   * The source map for the transformed code, if applicable.\n   */\n  map?: string | null;\n}\n\n/**\n * CommandKit plugin that runs at compile time.\n */\nexport abstract class CompilerPlugin<\n  T extends PluginOptions = PluginOptions,\n> extends PluginCommon<T, CompilerPluginRuntime> {\n  /**\n   * The type of the plugin, which is Compiler.\n   */\n  public readonly type = PluginType.Compiler;\n\n  /**\n   * Called when transformation is requested to this plugin\n   * @param params The parameters for the transformation\n   * @returns The transformed result\n   */\n  public async transform(\n    params: PluginTransformParameters,\n  ): Promise<MaybeFalsey<TransformedResult>> {\n    return null;\n  }\n}\n\n/**\n * Type guard to check if the given object is a CompilerPlugin.\n * @param plugin The object to check.\n * @returns Boolean indicating whether the object is a CompilerPlugin.\n */\nexport function isCompilerPlugin(plugin: unknown): plugin is CompilerPlugin {\n  return (\n    plugin instanceof CompilerPlugin ||\n    (isPlugin(plugin) && plugin.type === PluginType.Compiler)\n  );\n}\n"],"mappings":";;;;;;AAqCA,IAAsB,iBAAtB,cAEA,kCAAuC;;;;CAIrC,AAAgB,OAAO,gCAAW;;;;;;CAOlC,MAAa,UACb,QAC0C;AACxC,SAAO;;;;;;;;AASX,SAAgB,iBAAiB,QAA2C;AAC1E,QACE,kBAAkB,kBAClB,8BAAS,OAAO,IAAI,OAAO,SAAS,gCAAW"}