meocord 3.2.2 → 4.0.0-beta.0

package/dist/types/interface/index.d.ts

@@ -1,13 +1,8 @@
-import { SlashCommandBuilder, SlashCommandSubcommandsOnlyBuilder, ContextMenuCommandBuilder, RESTPostAPIPrimaryEntryPointApplicationCommandJSONBody, ChatInputCommandInteraction, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, PrimaryEntryPointCommandInteraction, ButtonInteraction, StringSelectMenuInteraction, UserSelectMenuInteraction, RoleSelectMenuInteraction, MentionableSelectMenuInteraction, ChannelSelectMenuInteraction, ModalSubmitInteraction, User, PartialUser, BaseInteraction, Message, MessageReaction } from 'discord.js';
-import { Configuration } from 'webpack';
+import { SlashCommandBuilder, SlashCommandOptionsOnlyBuilder, SlashCommandSubcommandsOnlyBuilder, ContextMenuCommandBuilder, RESTPostAPIPrimaryEntryPointApplicationCommandJSONBody, ChatInputCommandInteraction, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, PrimaryEntryPointCommandInteraction, ButtonInteraction, StringSelectMenuInteraction, UserSelectMenuInteraction, RoleSelectMenuInteraction, MentionableSelectMenuInteraction, ChannelSelectMenuInteraction, ModalSubmitInteraction, User, PartialUser, BaseInteraction, Message, MessageReaction } from 'discord.js';
+import { RsbuildConfig } from '@rsbuild/core';
+export { RsbuildConfig } from '@rsbuild/core';
 import { CommandType, ReactionHandlerAction } from '../enum/index.js';
 
-/**
- * MeoCord Framework
- * Copyright (c) 2025-present Ukasyah Rahmatullah Zada
- * SPDX-License-Identifier: MIT
- */
-
 /**
  * The command types that are registered with Discord, and so need a builder.
  *
@@ -28,11 +23,16 @@ type PrimaryEntryPointCommandData = RESTPostAPIPrimaryEntryPointApplicationComma
 /**
  * The payload `build()` returns for a given command type.
  *
+ * A slash command's builder changes type as it is chained: adding an option narrows
+ * `SlashCommandBuilder` to `SlashCommandOptionsOnlyBuilder`, adding a subcommand to
+ * `SlashCommandSubcommandsOnlyBuilder`. All three are accepted; the options form is the most
+ * common builder there is, one command with an option.
+ *
  * `PRIMARY_ENTRY_POINT` yields a raw REST body rather than a builder because
  * `@discordjs/builders` ships none for it; `ApplicationCommandManager#set` accepts the
  * JSON body directly, so nothing is lost.
  */
-type CommandBuildResult<T extends BuildableCommandType> = T extends CommandType.SLASH ? SlashCommandBuilder | SlashCommandSubcommandsOnlyBuilder : T extends CommandType.CONTEXT_MENU ? ContextMenuCommandBuilder : T extends CommandType.PRIMARY_ENTRY_POINT ? PrimaryEntryPointCommandData : never;
+type CommandBuildResult<T extends BuildableCommandType> = T extends CommandType.SLASH ? SlashCommandBuilder | SlashCommandOptionsOnlyBuilder | SlashCommandSubcommandsOnlyBuilder : T extends CommandType.CONTEXT_MENU ? ContextMenuCommandBuilder : T extends CommandType.PRIMARY_ENTRY_POINT ? PrimaryEntryPointCommandData : never;
 /**
  * Base interface for a command builder.
  */
@@ -88,12 +88,6 @@ interface ComponentInteractionMap {
 }
 type CommandInteractionType<CBC extends BuildableCommandType, T extends CommandBuilderConstructor<CBC> | CommandType> = T extends CommandBuilderConstructor<CommandType.SLASH> ? ChatInputCommandInteraction : T extends CommandBuilderConstructor<CommandType.CONTEXT_MENU> ? UserContextMenuCommandInteraction | MessageContextMenuCommandInteraction : T extends CommandBuilderConstructor<CommandType.PRIMARY_ENTRY_POINT> ? PrimaryEntryPointCommandInteraction : T extends keyof ComponentInteractionMap ? ComponentInteractionMap[T] : never;
 
-/**
- * MeoCord Framework
- * Copyright (c) 2025-present Ukasyah Rahmatullah Zada
- * SPDX-License-Identifier: MIT
- */
-
 /**
  * Interface for Guard classes.
  * Guards are used to handle permission checks before executing a method.
@@ -119,45 +113,10 @@ interface ReactionHandlerOptions {
     /** The action performed on the reaction, such as adding or removing it. */
     action: ReactionHandlerAction;
 }
-/**
- * Interface representing the Webpack configuration for the MeoCord framework.
- * This interface extends the base Webpack Configuration and provides stricter type definitions
- * with additional required properties to ensure a complete and valid Webpack setup.
- */
-interface MeoCordWebpackConfig extends Omit<Configuration, 'externals'> {
-    /** Defines the mode of the Webpack build process (e.g., 'development' or 'production'). */
-    mode: NonNullable<Configuration['mode']>;
-    /** The entry point file path(s) for the application. Represents the starting point(s) of the build. */
-    entry: string;
-    /** Configuration for build optimization settings, such as code splitting and minimization. */
-    optimization: NonNullable<Configuration['optimization']>;
-    /**
-     * Specifies external dependencies to exclude from the output bundle.
-     * Can be used to exclude libraries from being bundled, like `node_modules`.
-     */
-    externals: Extract<NonNullable<Configuration['externals']>, any[]>;
-    /**
-     * Rules and configurations for handling module files during the build process.
-     * Includes loaders for processing various file types.
-     */
-    module: NonNullable<Configuration['module']>;
-    /**
-     * Configuration for module resolution, including resolving extensions and alias paths.
-     * Determines how imported files are resolved.
-     */
-    resolve: NonNullable<Configuration['resolve']>;
-    /**
-     * Specifies output settings for the Webpack build, excluding path, publicPath, and filename.
-     * Defines properties like asset management and global settings.
-     */
-    output: Omit<NonNullable<Configuration['output']>, 'path' | 'publicPath' | 'filename'>;
-    /** Configures the stats object to control the output of build process logs. */
-    stats: NonNullable<Configuration['stats']>;
-}
 /**
  * Configuration interface for the MeoCord application.
  * This interface defines optional configurations for the application, including
- * metadata, authentication tokens, and Webpack configuration overrides.
+ * metadata, authentication tokens, and bundler configuration overrides.
  */
 interface MeoCordConfig {
     /**
@@ -170,12 +129,42 @@ interface MeoCordConfig {
      */
     discordToken: string;
     /**
-     * Function to customize the Webpack configuration.
-     * Allows overriding and extending the default Webpack setup for the application.
-     * @param config - A callback function to modify the existing Webpack configuration.
-     * @returns A modified Webpack configuration or `undefined` if no customization is needed.
+     * Put everything the bot needs inside `dist`, so it runs without `node_modules`.
+     *
+     * Off by default, matching how the build has always behaved: dependencies stay runtime imports,
+     * so `dist` needs `node_modules` beside it. Turn it on to deploy `dist` alone.
+     *
+     * Plain JavaScript is bundled into `main.js`. Native addons -- packages shipping a compiled
+     * `.node` binary, like `sharp` -- are found while building, kept out of the bundle, and copied
+     * with their platform binary into `dist/node_modules`. Such a build only runs on the platform it
+     * was built on; it records that platform, and refuses to start anywhere else.
+     */
+    bundleDependencies?: boolean;
+    /**
+     * Modules to keep out of the bundle.
+     *
+     * Native addons need not be listed; they are found and packed on their own. Anything listed here
+     * as a package name is also copied into `dist/node_modules` when {@link bundleDependencies} is on.
+     *
+     * @example
+     * ```ts
+     * // Loaded by the runtime rather than bundled, e.g. for instrumentation.
+     * externals: ['@opentelemetry/api']
+     * ```
+     */
+    externals?: (string | RegExp)[];
+    /**
+     * Function to customize the Rsbuild configuration.
+     * Allows overriding and extending the default bundler setup for the application.
+     *
+     * Rsbuild handles images, fonts, svg and media itself, so they need no rules;
+     * `output.distPath` controls where they land. Raw bundler rules go through `tools.rspack`,
+     * which takes a webpack-shaped config.
+     *
+     * @param config - The configuration to modify.
+     * @returns A modified configuration, or `undefined` to keep the default.
      */
-    webpack?: (config: MeoCordWebpackConfig) => MeoCordWebpackConfig | undefined;
+    rsbuild?: (config: RsbuildConfig) => RsbuildConfig | undefined;
 }
 
-export type { AutocompleteMetadata, BuildableCommandType, CommandBuildResult, CommandBuilderBase, CommandBuilderConstructor, CommandInteractionType, CommandMetadata, GuardInterface, MeoCordConfig, MeoCordWebpackConfig, ReactionHandlerOptions };
+export type { AutocompleteMetadata, BuildableCommandType, CommandBuildResult, CommandBuilderBase, CommandBuilderConstructor, CommandInteractionType, CommandMetadata, GuardInterface, MeoCordConfig, ReactionHandlerOptions };

package/dist/types/testing/index.d.ts

@@ -1,15 +1,9 @@
 import { ServiceIdentifier, Container } from 'inversify';
 import { GuardInterface } from '../interface/index.js';
 import { CacheType, CommandInteractionOptionResolver, Channel, Client, Guild, Message, User } from 'discord.js';
-import 'webpack';
+import '@rsbuild/core';
 import '../controller.enum-DYfhYaat.js';
 
-/**
- * MeoCord Framework
- * Copyright (c) 2025-present Ukasyah Rahmatullah Zada
- * SPDX-License-Identifier: MIT
- */
-
 interface ValueProvider<T = any> {
     provide: ServiceIdentifier<T>;
     useValue: T;
@@ -76,11 +70,6 @@ declare class MeoCordTestingModule {
     static create(options: TestingModuleOptions): TestingModuleBuilder;
 }
 
-/**
- * MeoCord Framework
- * Copyright (c) 2025-present Ukasyah Rahmatullah Zada
- * SPDX-License-Identifier: MIT
- */
 interface MockResult<T = unknown> {
     type: 'return' | 'throw';
     value: T;
@@ -140,12 +129,6 @@ declare function isMockFunction(fn: unknown): fn is MockInstance;
  */
 declare function createMockFn<T extends (...args: any[]) => any = (...args: any[]) => any>(impl?: T): MockedFunction<T>;
 
-/**
- * MeoCord Framework
- * Copyright (c) 2025-present Ukasyah Rahmatullah Zada
- * SPDX-License-Identifier: MIT
- */
-
 /**
  * Recursively transforms all methods of T into MockedFunction and all
  * nested objects into DeepMocked. Depth cap at 5 prevents infinite recursion
@@ -273,7 +256,9 @@ declare function createMockGuild(): DeepMocked<Guild>;
  * - `ThreadChannel`: `messages`, `members`
  */
 declare function createMockChannel<T extends Channel>(Class: InteractionClass<T>): DeepMocked<T>;
-declare function createMockMessage(): DeepMocked<Message>;
+declare function createMockMessage(): DeepMocked<Message> & {
+    deleted: boolean;
+};
 interface ChatInputOptions {
     subcommandGroup?: string | null;
     subcommand?: string | null;

package/meocord.eslint.cjs

@@ -1,9 +1,3 @@
-/**
- * MeoCord Framework
- * Copyright (c) 2025-present Ukasyah Rahmatullah Zada
- * SPDX-License-Identifier: MIT
- */
-
 const { importX } = require('eslint-plugin-import-x')
 const globals = require('globals')
 const tsParser = require('@typescript-eslint/parser')

package/meocord.eslint.d.ts

@@ -1,9 +1,3 @@
-/**
- * MeoCord Framework
- * Copyright (c) 2025-present Ukasyah Rahmatullah Zada
- * SPDX-License-Identifier: MIT
- */
-
 import type { Linter } from 'eslint'
 
 /**

package/meocord.eslint.mjs

@@ -1,9 +1,3 @@
-/**
- * MeoCord Framework
- * Copyright (c) 2025-present Ukasyah Rahmatullah Zada
- * SPDX-License-Identifier: MIT
- */
-
 import { importX } from 'eslint-plugin-import-x'
 import globals from 'globals'
 import tsParser from '@typescript-eslint/parser'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "meocord",
   "description": "Decorator-based Discord bot framework built on discord.js. Brings NestJS-style controllers, dependency injection, guards, and testing utilities to bot development — with a full CLI and TypeScript-first design.",
-  "version": "3.2.2",
+  "version": "4.0.0-beta.0",
   "type": "module",
   "engines": {
     "node": ">=22"
@@ -18,8 +18,10 @@
     "test:coverage": "vitest run --coverage",
     "test:typecheck": "tsc --noEmit --project tsconfig.test.json",
     "changeset": "changeset",
-    "release:version": "changeset version",
-    "release:publish": "changeset publish"
+    "release:version": "changeset version && prettier --write CHANGELOG.md",
+    "release:publish": "changeset publish",
+    "notices": "bun scripts/third-party-notices.ts",
+    "notices:check": "bun scripts/third-party-notices.ts --check"
   },
   "bin": "./dist/esm/bin/meocord.js",
   "repository": {
@@ -70,7 +72,6 @@
   },
   "files": [
     "dist/**/*",
-    "webpack.config.js",
     "meocord.eslint.mjs",
     "meocord.eslint.cjs",
     "meocord.eslint.d.ts",
@@ -78,11 +79,12 @@
     "LICENSE",
     "AUTHOR.md",
     "CHANGELOG.md",
+    "THIRD_PARTY_NOTICES.md",
     "README.md"
   ],
   "dependencies": {
     "@clack/prompts": "^1.8.0",
-    "@swc/core": "1.16.2",
+    "@rsbuild/core": "^2.2.8",
     "chalk": "^6.0.0",
     "cli-table3": "^0.6.5",
     "commander": "^15.0.0",
@@ -91,46 +93,40 @@
     "jiti": "^2.7.0",
     "lodash-es": "^4.18.1",
     "reflect-metadata": "^0.2.2",
-    "simple-git": "^3.36.0",
-    "swc-loader": "^0.2.7",
-    "terser-webpack-plugin": "^5.6.1",
-    "tsconfig-paths-webpack-plugin": "^4.2.0",
-    "webpack": "^5.110.3",
-    "webpack-node-externals": "^3.0.0"
+    "simple-git": "^3.36.0"
   },
   "devDependencies": {
     "@changesets/changelog-github": "^1.0.1",
-    "@changesets/cli": "^3.0.2",
+    "@changesets/cli": "^3.0.3",
     "@eslint/js": "^10.0.1",
     "@rollup/plugin-alias": "^6.0.0",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-swc": "^0.4.1",
     "@types/lodash-es": "^4.17.12",
-    "@types/webpack-node-externals": "^3.0.4",
-    "@typescript-eslint/parser": "^8.70.0",
+    "@typescript-eslint/parser": "^8.70.1",
+    "@vitest/coverage-istanbul": "^5.0.1",
     "discord.js": "^14.27.0",
-    "eslint": "^10.10.0",
+    "dotenv": "^18.0.3",
+    "eslint": "^10.11.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-headers": "^1.3.4",
     "eslint-plugin-import-x": "^4.17.1",
     "eslint-plugin-prettier": "^5.5.6",
     "eslint-plugin-unused-imports": "^4.4.1",
     "globals": "^17.12.0",
     "husky": "^9.1.7",
-    "prettier": "^3.9.6",
-    "rollup": "^4.63.1",
+    "prettier": "^3.9.8",
+    "rollup": "^4.63.4",
     "rollup-plugin-copy": "^3.5.0",
     "rollup-plugin-dts": "^6.5.1",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.70.0",
-    "@vitest/coverage-istanbul": "^5.0.0",
-    "unplugin-swc": "^1.6.0",
-    "vitest": "^5.0.0"
+    "typescript-eslint": "^8.70.1",
+    "unplugin-swc": "^2.0.0",
+    "vitest": "^5.0.1"
   },
   "peerDependencies": {
     "discord.js": "^14.26.4",
-    "dotenv": "^17.4.2"
+    "dotenv": "^18.0.3"
   },
   "publishConfig": {
     "provenance": true

package/webpack.config.js

@@ -1,147 +0,0 @@
-/**
- * MeoCord Framework
- * Copyright (c) 2025-present Ukasyah Rahmatullah Zada
- * SPDX-License-Identifier: MIT
- */
-
-import path from 'path'
-import TsconfigPathsPlugin from 'tsconfig-paths-webpack-plugin'
-import TerserPlugin from 'terser-webpack-plugin'
-import { loadMeoCordConfig } from './dist/esm/util/meocord-config-loader.util.js'
-import { prepareModifiedTsConfig } from './dist/esm/util/tsconfig.util.js'
-import nodeExternals from 'webpack-node-externals'
-
-const CWD = process.cwd()
-const IS_PRODUCTION = process.env.NODE_ENV === 'production'
-const SRC_DIR = path.resolve(CWD, 'src')
-const DIST_DIR = path.resolve(CWD, 'dist')
-
-// Note: meocordConfig is loaded lazily inside createWebpackConfig()
-// to avoid Bun's aggressive module caching issues in Docker containers
-const tsConfigPath = prepareModifiedTsConfig()
-
-const baseRules = [
-  {
-    test: /\.ts$/,
-    use: {
-      loader: 'swc-loader',
-      options: {
-        jsc: {
-          parser: {
-            syntax: 'typescript',
-            tsx: false,
-            decorators: true,
-          },
-          transform: {
-            decoratorMetadata: true,
-            legacyDecorator: true,
-          },
-        },
-      },
-    },
-    exclude: /node_modules/,
-  },
-]
-
-/**
- * Merges two arrays returning unique elements
- */
-const mergeUnique = (base = [], additions = []) => Array.from(new Set([...base, ...additions]))
-
-/**
- * Creates webpack configuration with framework defaults
- */
-const createWebpackConfig = (overrides = {}) => {
-  const baseConfig = {
-    mode: overrides.mode ?? (IS_PRODUCTION ? 'production' : 'development'),
-    entry: overrides.entry ?? path.resolve(SRC_DIR, 'main.ts'),
-    target: 'node',
-    externals: mergeUnique([nodeExternals({ importType: 'module' })], overrides.externals),
-    module: {
-      ...overrides.module,
-      rules: mergeUnique(baseRules, overrides.module?.rules),
-    },
-    resolve: {
-      ...overrides.resolve,
-      extensions: mergeUnique(['.ts', '.js'], overrides.resolve?.extensions),
-      plugins: mergeUnique([new TsconfigPathsPlugin({ configFile: tsConfigPath })], overrides.resolve?.plugins),
-    },
-    output: {
-      filename: 'main.js',
-      path: DIST_DIR,
-      publicPath: path.join(process.cwd(), 'dist/'),
-      library: { type: 'module' },
-      ...overrides.output,
-    },
-    experiments: {
-      outputModule: true,
-      ...overrides.experiments,
-    },
-    stats: overrides.stats ?? (IS_PRODUCTION ? 'normal' : 'errors-warnings'),
-    devtool: overrides.devtool ?? (IS_PRODUCTION ? 'source-map' : 'eval-source-map'),
-    performance: {
-      hints: overrides.performance?.hints ?? (IS_PRODUCTION ? 'warning' : false),
-      ...overrides.performance,
-    },
-    ...overrides,
-    optimization: {
-      ...overrides.optimization,
-      minimize: overrides.optimization?.minimize ?? IS_PRODUCTION,
-      minimizer: [],
-    },
-  }
-
-  const finalMinimizerArray = []
-  const shouldMinimize = baseConfig.optimization.minimize
-
-  if (shouldMinimize) {
-    const userProvidedMinimizers = overrides.optimization?.minimizer
-    let lastTerserInstance = null
-    const otherMinimizers = []
-
-    if (Array.isArray(userProvidedMinimizers)) {
-      for (let i = userProvidedMinimizers.length - 1; i >= 0; i--) {
-        const minimizer = userProvidedMinimizers[i]
-        if (minimizer?.constructor?.name === 'TerserPlugin') {
-          if (!lastTerserInstance) {
-            lastTerserInstance = minimizer
-          }
-        } else if (minimizer) {
-          otherMinimizers.unshift(minimizer)
-        }
-      }
-    }
-
-    finalMinimizerArray.push(...otherMinimizers)
-
-    let terserPluginToUse
-    if (lastTerserInstance) {
-      terserPluginToUse = new TerserPlugin({
-        test: lastTerserInstance.options?.test,
-        include: lastTerserInstance.options?.include,
-        exclude: lastTerserInstance.options?.exclude,
-        extractComments: lastTerserInstance.options?.extractComments,
-        parallel: lastTerserInstance.options?.parallel,
-        minify: lastTerserInstance.options?.minify,
-        terserOptions: {
-          ...(lastTerserInstance.options?.terserOptions || {}),
-          keep_classnames: true,
-        },
-      })
-    } else {
-      terserPluginToUse = new TerserPlugin({ terserOptions: { keep_classnames: true } })
-    }
-
-    finalMinimizerArray.push(terserPluginToUse)
-  }
-
-  baseConfig.optimization.minimizer = finalMinimizerArray
-
-  return baseConfig
-}
-
-// Load user config lazily (fixes Bun Docker caching issues)
-const meocordConfig = loadMeoCordConfig()
-const initialConfig = createWebpackConfig()
-const userModifiedConfig = meocordConfig?.webpack?.(initialConfig)
-export default createWebpackConfig(userModifiedConfig ?? {})