meocord 4.1.2 → 4.2.1

package/dist/cli.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "meocordVersion": "4.1.2",
+  "meocordVersion": "4.2.1",
   "name": "meocord",
   "description": "CLI for managing the MeoCord application",
   "usage": "[options] [command]",

package/dist/esm/bin/app-template/README.md.template

@@ -94,7 +94,9 @@ interceptors, filters })`. An observer hears about every call once listed in
 `meocord/testing` provides `MeoCordTestingModule` for building a controller with its
 dependencies, `invoke` for running a handler through its guards, interceptors and
 filters as the bot does, and `createMockInteraction` and friends for driving it without
-a Discord connection. `vitest.setup.ts` resets those mocks after every test, so set
+a Discord connection. `vitest.setup.ts` has those mocks made with `vi.fn`, so Vitest
+treats them as its own, and has them compute what discord.js computes, such as a
+message's `editable`, rather than placeholders. It resets them after every test, so set
 what a mock returns in the test, or in `beforeEach`, that relies on it.
 
 ## Linting

package/dist/esm/bin/app-template/src/controllers/button/sample.button.controller.spec.ts.template

@@ -9,6 +9,10 @@ import {
 } from 'meocord/testing'
 import { SampleButtonController } from '@src/controllers/button/sample.button.controller.js'
 
+// Discord user ids, as the customId and the guard compare them
+const owner = '200000000000000001'
+const stranger = '200000000000000002'
+
 const clickBy = (userId: string, customId = 'button-click') => {
   const user = createMockUser()
   user.id = userId
@@ -19,7 +23,7 @@ describe('SampleButtonController', () => {
   const module = MeoCordTestingModule.create({ controllers: [SampleButtonController] }).compile()
 
   it('locks the message while it works, then answers', async () => {
-    const interaction = clickBy('someone')
+    const interaction = clickBy(stranger)
 
     await module.invoke(SampleButtonController, 'handleButton', interaction)
 
@@ -29,16 +33,16 @@ describe('SampleButtonController', () => {
   })
 
   it('answers the owner of the button', async () => {
-    const interaction = clickBy('owner', 'button-with/owner')
+    const interaction = clickBy(owner, `button-with/${owner}`)
 
     // The customId's route gives the handler its ownerId
     await module.invoke(SampleButtonController, 'handleButtonWithId', interaction)
 
-    expect(getResponse(interaction).calls.at(-1)?.payload).toMatchObject({ content: 'Button of <@owner> clicked!' })
+    expect(getResponse(interaction).calls.at(-1)?.payload).toMatchObject({ content: `Button of <@${owner}> clicked!` })
   })
 
   it('denies anyone else before touching the message', async () => {
-    const interaction = clickBy('stranger', 'button-with/owner')
+    const interaction = clickBy(stranger, `button-with/${owner}`)
 
     await expect(module.invoke(SampleButtonController, 'handleButtonWithId', interaction)).rejects.toThrow(
       GuardDeniedError,

package/dist/esm/bin/app-template/src/controllers/button/sample.button.controller.ts.template

@@ -15,8 +15,8 @@ export class SampleButtonController {
     await respond(interaction).send({ content: 'Button clicked!' })
   }
 
-  // Only the user whose id the customId carries gets past OwnerGuard
-  @Command('button-with/{ownerId}', CommandType.BUTTON)
+  // Only the user whose id the customId carries gets past OwnerGuard; `:snowflake` takes only a Discord id
+  @Command('button-with/{ownerId:snowflake}', CommandType.BUTTON)
   @UseGuard(OwnerGuard)
   @Cooldown({ uses: 5, seconds: 60 })
   @Defer()

package/dist/esm/bin/app-template/src/guards/owner.guard.spec.ts.template

@@ -7,30 +7,34 @@ import { OwnerGuard } from '@src/guards/owner.guard.js'
 
 @Controller()
 class CardController {
-  @Command('card/{ownerId}', CommandType.BUTTON)
+  @Command('card/{ownerId:snowflake}', CommandType.BUTTON)
   @UseGuard(OwnerGuard)
   async open(interaction: ButtonInteraction) {
     await interaction.deferUpdate()
   }
 }
 
+// Discord user ids, as the customId and the guard compare them
+const owner = '200000000000000001'
+const stranger = '200000000000000002'
+
 const clickBy = (userId: string) => {
   const user = createMockUser()
   user.id = userId
   // invoke reads ownerId from the customId, as dispatch does
-  return createMockInteraction(ButtonInteraction, { customId: 'card/owner', user })
+  return createMockInteraction(ButtonInteraction, { customId: `card/${owner}`, user })
 }
 
 describe('OwnerGuard', () => {
   const module = MeoCordTestingModule.create({ controllers: [CardController] }).compile()
 
   it("lets the button's owner through", async () => {
-    const { ran } = await module.invoke(CardController, 'open', clickBy('owner'))
+    const { ran } = await module.invoke(CardController, 'open', clickBy(owner))
 
     expect(ran).toBe(true)
   })
 
   it('denies anyone else with a GuardDeniedError', async () => {
-    await expect(module.invoke(CardController, 'open', clickBy('stranger'))).rejects.toThrow(GuardDeniedError)
+    await expect(module.invoke(CardController, 'open', clickBy(stranger))).rejects.toThrow(GuardDeniedError)
   })
 })

package/dist/esm/bin/app-template/src/guards/owner.guard.ts.template

@@ -3,7 +3,7 @@ import { Guard } from 'meocord/decorator'
 import { GuardDeniedError } from 'meocord/common'
 import { type GuardInterface } from 'meocord/interface'
 
-/** Lets only the user whose id a button carries use it: `@Command('card/{ownerId}', ...)` */
+/** Lets only the user whose id a button carries use it: `@Command('card/{ownerId:snowflake}', ...)` */
 @Guard()
 export class OwnerGuard implements GuardInterface {
   canActivate(interaction: ButtonInteraction, { ownerId }: { ownerId: string }): boolean {

package/dist/esm/bin/app-template/vitest.config.ts.template

@@ -24,7 +24,7 @@ export default defineConfig({
   test: {
     globals: true,
     setupFiles: ['./vitest.setup.ts'],
-    // vi.fn() mocks only; vitest.setup.ts resets the mocks from meocord/testing
+    // Every mock's calls, meocord/testing's included; vitest.setup.ts also resets meocord's to how each was created
     clearMocks: true,
     include: ['src/**/*.spec.ts'],
     coverage: {

package/dist/esm/bin/app-template/vitest.setup.ts.template

@@ -1,6 +1,10 @@
 import 'reflect-metadata'
-import { resetAllMocks } from 'meocord/testing'
-import { afterEach } from 'vitest'
+import { resetAllMocks, useMockFn, useStrictMocks } from 'meocord/testing'
+import { afterEach, vi } from 'vitest'
 
-// Every test starts from mocks as they were created: clearMocks in vitest.config.ts reaches only vi.fn()
+// meocord/testing makes its mocks with vi.fn, so Vitest's matchers, config and vi.mocked() treat them as its own
+useMockFn(vi.fn)
+// Mocks compute what discord.js computes, such as a message's editable or a member's kickable, rather than placeholders
+useStrictMocks()
+// Every test starts from meocord's mocks as they were created
 afterEach(() => resetAllMocks())

package/dist/esm/bin/generator.js

@@ -9,16 +9,15 @@ import '../core/theme-validation.js';
 import '../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
-import '../common/translator.js';
-import '../common/response/send-failure.js';
-import '../util/interaction.util.js';
-import '../common/response/flags.js';
-import '../common/response/components.js';
+import '../common/response/response-state.js';
+import '../common/errors.js';
 import 'node:crypto';
 import '../decorator/controller.decorator.js';
 import '../core/scalar-types.js';
 import 'node:fs';
 import 'node:url';
+import '../common/translator.js';
+import '../common/meocord-text.js';
 import { ServiceGeneratorHelper } from './helper/service-generator.helper.js';
 import { GuardGeneratorHelper } from './helper/guard-generator.helper.js';
 import { InterceptorGeneratorHelper } from './helper/interceptor-generator.helper.js';

package/dist/esm/bin/helper/filter-generator.helper.js

@@ -5,16 +5,15 @@ import '../../core/theme-validation.js';
 import '../../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
-import '../../common/translator.js';
-import '../../common/response/send-failure.js';
-import '../../util/interaction.util.js';
-import '../../common/response/flags.js';
-import '../../common/response/components.js';
+import '../../common/response/response-state.js';
+import '../../common/errors.js';
 import 'node:crypto';
 import '../../decorator/controller.decorator.js';
 import '../../core/scalar-types.js';
 import 'node:fs';
 import 'node:url';
+import '../../common/translator.js';
+import '../../common/meocord-text.js';
 import { validateAndFormatName, assertFilesAbsent, buildTemplate, createDirectoryIfNotExists, writeFiles } from '../../util/generator-cli.util.js';
 
 class FilterGeneratorHelper {

package/dist/esm/bin/helper/guard-generator.helper.js

@@ -5,16 +5,15 @@ import '../../core/theme-validation.js';
 import '../../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
-import '../../common/translator.js';
-import '../../common/response/send-failure.js';
-import '../../util/interaction.util.js';
-import '../../common/response/flags.js';
-import '../../common/response/components.js';
+import '../../common/response/response-state.js';
+import '../../common/errors.js';
 import 'node:crypto';
 import '../../decorator/controller.decorator.js';
 import '../../core/scalar-types.js';
 import 'node:fs';
 import 'node:url';
+import '../../common/translator.js';
+import '../../common/meocord-text.js';
 import { validateAndFormatName, assertFilesAbsent, buildTemplate, createDirectoryIfNotExists, writeFiles } from '../../util/generator-cli.util.js';
 
 class GuardGeneratorHelper {

package/dist/esm/bin/helper/interceptor-generator.helper.js

@@ -5,16 +5,15 @@ import '../../core/theme-validation.js';
 import '../../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
-import '../../common/translator.js';
-import '../../common/response/send-failure.js';
-import '../../util/interaction.util.js';
-import '../../common/response/flags.js';
-import '../../common/response/components.js';
+import '../../common/response/response-state.js';
+import '../../common/errors.js';
 import 'node:crypto';
 import '../../decorator/controller.decorator.js';
 import '../../core/scalar-types.js';
 import 'node:fs';
 import 'node:url';
+import '../../common/translator.js';
+import '../../common/meocord-text.js';
 import { validateAndFormatName, assertFilesAbsent, buildTemplate, createDirectoryIfNotExists, writeFiles } from '../../util/generator-cli.util.js';
 
 class InterceptorGeneratorHelper {

package/dist/esm/bin/helper/observer-generator.helper.js

@@ -5,16 +5,15 @@ import '../../core/theme-validation.js';
 import '../../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
-import '../../common/translator.js';
-import '../../common/response/send-failure.js';
-import '../../util/interaction.util.js';
-import '../../common/response/flags.js';
-import '../../common/response/components.js';
+import '../../common/response/response-state.js';
+import '../../common/errors.js';
 import 'node:crypto';
 import '../../decorator/controller.decorator.js';
 import '../../core/scalar-types.js';
 import 'node:fs';
 import 'node:url';
+import '../../common/translator.js';
+import '../../common/meocord-text.js';
 import { validateAndFormatName, assertFilesAbsent, buildTemplate, createDirectoryIfNotExists, writeFiles } from '../../util/generator-cli.util.js';
 
 class ObserverGeneratorHelper {

package/dist/esm/bin/helper/pipe-generator.helper.js

@@ -5,16 +5,15 @@ import '../../core/theme-validation.js';
 import '../../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
-import '../../common/translator.js';
-import '../../common/response/send-failure.js';
-import '../../util/interaction.util.js';
-import '../../common/response/flags.js';
-import '../../common/response/components.js';
+import '../../common/response/response-state.js';
+import '../../common/errors.js';
 import 'node:crypto';
 import '../../decorator/controller.decorator.js';
 import '../../core/scalar-types.js';
 import 'node:fs';
 import 'node:url';
+import '../../common/translator.js';
+import '../../common/meocord-text.js';
 import { validateAndFormatName, assertFilesAbsent, buildTemplate, createDirectoryIfNotExists, writeFiles } from '../../util/generator-cli.util.js';
 
 class PipeGeneratorHelper {

package/dist/esm/bin/helper/service-generator.helper.js

@@ -5,16 +5,15 @@ import '../../core/theme-validation.js';
 import '../../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
-import '../../common/translator.js';
-import '../../common/response/send-failure.js';
-import '../../util/interaction.util.js';
-import '../../common/response/flags.js';
-import '../../common/response/components.js';
+import '../../common/response/response-state.js';
+import '../../common/errors.js';
 import 'node:crypto';
 import '../../decorator/controller.decorator.js';
 import '../../core/scalar-types.js';
 import 'node:fs';
 import 'node:url';
+import '../../common/translator.js';
+import '../../common/meocord-text.js';
 import { validateAndFormatName, assertFilesAbsent, buildTemplate, createDirectoryIfNotExists, writeFiles } from '../../util/generator-cli.util.js';
 
 class ServiceGeneratorHelper {

package/dist/esm/bin/meocord.js

@@ -8,22 +8,21 @@ import '../core/theme-validation.js';
 import '../common/decorator.js';
 import 'reflect-metadata';
 import 'discord.js';
-import '../common/translator.js';
-import '../common/response/send-failure.js';
-import '../util/interaction.util.js';
-import '../common/response/flags.js';
-import '../common/response/components.js';
+import '../common/response/response-state.js';
+import '../common/errors.js';
 import '../decorator/controller.decorator.js';
 import '../core/scalar-types.js';
 import * as fs from 'node:fs';
 import 'node:url';
+import '../common/translator.js';
+import '../common/meocord-text.js';
 import { spawn } from 'node:child_process';
 import { capitalize } from 'lodash-es';
 import wait from '../util/wait.util.js';
 import { GeneratorCLI } from './generator.js';
 import { runtimePrefixFor, AppGeneratorHelper } from './helper/app-generator.helper.js';
 import { makeInitialCommit } from './helper/initial-commit.helper.js';
-import { setEnvironment, compileAndValidateConfig, validateRunConfig, validateDiscordToken } from '../util/common.util.js';
+import { setEnvironment, compileAndValidateConfig, validateRunConfig, validateDiscordToken, checkSourceConfig, reportConfigProblem } from '../util/common.util.js';
 import { Command } from 'commander';
 import { execSync } from 'child_process';
 import * as p from '@clack/prompts';
@@ -38,7 +37,7 @@ import { isDevRunnerMessage, DEV_RUNNER_ENV } from '../util/dev-runner.util.js';
 import packageJson from '../package.json.js';
 import { fileURLToPath } from 'url';
 import { assertNoWebpackHook, createRsbuildConfig, optionalExternalConflicts, optionalExternalNames } from '../build/rsbuild-config.js';
-import { createNativeExternals, installedPackages, copyPackagesInto, bundledModuleFiles, assertNoBundledNativeAddons, findBundledNativeAddons } from '../build/native-addons.js';
+import { createNativeExternals, packageNameOfRequest, installedPackages, copyPackagesInto, bundledModuleFiles, assertNoBundledNativeAddons, findBundledNativeAddons } from '../build/native-addons.js';
 import { writePlatformManifest, PLATFORM_MANIFEST } from '../util/platform.util.js';
 import { loadMeoCordSourceConfig } from '../util/meocord-source-config.util.js';
 import { loadMeoCordConfig } from '../util/meocord-config-loader.util.js';
@@ -94,6 +93,29 @@ const __dirname$1 = path.dirname(__filename$1);
     }
     return digest.digest('hex');
 }
+// Latin letters that do not decompose into a base letter and a mark
+const UNDECOMPOSED = {
+    ß: 'ss',
+    ẞ: 'SS',
+    æ: 'ae',
+    Æ: 'Ae',
+    œ: 'oe',
+    Œ: 'Oe',
+    ø: 'o',
+    Ø: 'O',
+    ł: 'l',
+    Ł: 'L',
+    đ: 'd',
+    Đ: 'D',
+    þ: 'th',
+    Þ: 'Th'
+};
+/**
+ * The folder `meocord create` writes an app named `appName` into, which is also its package name: kebab case, ASCII.
+ * Accents fold to their base letters first, so "CaféBot" splits as "CafeBot" does, into `cafe-bot`.
+ */ function appDirectoryName(appName) {
+    return appName.normalize('NFKD').replace(/\p{M}+/gu, '').replace(/[ßẞæÆœŒøØłŁđĐþÞ]/g, (letter)=>UNDECOMPOSED[letter]).replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+}
 /** A Command Line Interface (CLI) for managing the MeoCord application. */ class MeoCordCLI {
     /**
    * Configures and runs the MeoCord CLI.
@@ -191,12 +213,12 @@ copies or substantial portions of the Software.
         return program;
     }
     async createApp(appName, options) {
-        const kebabCaseAppName = appName.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+        const kebabCaseAppName = appDirectoryName(appName);
         const appPath = path.resolve(process.cwd(), kebabCaseAppName);
         p.intro(`meocord v${this.version}`);
         // A name of only symbols would resolve to the current directory itself.
         if (!kebabCaseAppName) {
-            p.cancel(`"${appName}" needs a name with letters or digits, such as my-bot: it names the app's directory.`);
+            p.cancel(`"${appName}" needs a name with Latin letters or digits, such as my-bot: it names the app's directory.`);
             await wait(100);
             process.exit(1);
         }
@@ -307,7 +329,7 @@ copies or substantial portions of the Software.
             optionalExternals: meocordConfig?.optionalExternals
         });
         for (const name of optionalExternalConflicts(meocordConfig?.optionalExternals, meocordConfig?.externals)){
-            this.logger.warn(`"${name}" is in both optionalExternals and externals. In externals it becomes an import that runs ` + `before the bot's code and fails when the package is missing; remove it from externals.`);
+            this.logger.warn(`"${name}" is in both optionalExternals and externals. In externals, an ESM import of it runs as its importer ` + `loads and fails when the package is missing, where a require stays optional; remove it from externals.`);
         }
         const config = meocordConfig?.rsbuild?.(base) ?? base;
         // A native addon cannot be inlined into JavaScript, so when bundling, each one is kept out of
@@ -349,10 +371,13 @@ copies or substantial portions of the Software.
                 dir
             ]));
         const nativeNames = new Set(natives.keys());
-        const listed = (meocordConfig.externals ?? []).filter((item)=>typeof item === 'string');
+        // The package a string external is in, so one naming a file inside a package, such as 'lodash/fp.js', packs it
+        const listed = (meocordConfig.externals ?? []).flatMap((item)=>typeof item === 'string' ? packageNameOfRequest(item) ?? [] : []);
         const wanted = [
-            ...listed,
-            ...optionalExternalNames(meocordConfig.optionalExternals)
+            ...new Set([
+                ...listed,
+                ...optionalExternalNames(meocordConfig.optionalExternals)
+            ])
         ].filter((name)=>!packages.has(name));
         for (const { name, dir, native } of installedPackages(wanted, this.projectRoot)){
             packages.set(name, dir);
@@ -382,6 +407,22 @@ copies or substantial portions of the Software.
             this.logger.info(`dist/node_modules holds ${count}; nothing else to install.`);
         }
     }
+    /**
+   * Removes what {@link packDependencies} wrote, after a build without `bundleDependencies`, so its bundle resolves
+   * packages from the project rather than from a previous self-contained build's copy. Nothing else in dist is touched.
+   */ removePackedOutputs() {
+        const dist = path.join(this.projectRoot, 'dist');
+        for (const output of [
+            'node_modules',
+            'package.json',
+            PLATFORM_MANIFEST
+        ]){
+            fs.rmSync(path.join(dist, output), {
+                recursive: true,
+                force: true
+            });
+        }
+    }
     /** Builds the application in the given mode. */ async build(mode) {
         try {
             this.logger.info(`Building ${mode} version...`);
@@ -398,6 +439,8 @@ copies or substantial portions of the Software.
                 // bundle would run on this machine -- through its node_modules -- and fail in production.
                 assertNoBundledNativeAddons(findBundledNativeAddons(bundledFiles, this.projectRoot));
                 this.packDependencies(meocordConfig, natives.found);
+            } else if (!meocordConfig?.bundleDependencies) {
+                this.removePackedOutputs();
             }
             this.logger.info(`${capitalize(mode)} build completed successfully.`);
         } catch (error) {
@@ -431,7 +474,8 @@ copies or substantial portions of the Software.
                 mode,
                 entry: configPath,
                 bundleDependencies,
-                externals: meocordConfig?.externals
+                externals: meocordConfig?.externals,
+                requireable: true
             });
             fs.mkdirSync(dist, {
                 recursive: true
@@ -503,6 +547,13 @@ copies or substantial portions of the Software.
    * Runs the built application in register-only mode: it collects the commands from the bundle, sends
    * them over REST and exits, without logging in. Exits with the application's code.
    */ async register(guild) {
+        // An unset variable passed as the guild: registering where commands.* says instead could publish everywhere
+        if (guild !== undefined && !guild.trim()) {
+            this.logger.error('--guild was given no guild id, so nothing is registered. Pass a guild id, or leave --guild out to register where commands.* says.');
+            await wait(100);
+            process.exit(1);
+            return;
+        }
         if (!fs.existsSync(this.mainJSPath)) {
             this.logger.error('Main entry file (main.js) not found! Build first, or run `meocord register --build`.');
             await wait(100);
@@ -625,10 +676,8 @@ copies or substantial portions of the Software.
             cwd: this.projectRoot,
             env: {
                 ...this.inheritedEnv,
-                // Watch mode runs a development build, whose config reads the development files; Bun reads them for this too
-                ...devRunner ? {
-                    NODE_ENV: 'development'
-                } : process.env.NODE_ENV !== undefined && {
+                // The mode the command set, development for --dev, so the bot's config and Bun read the same .env files as the CLI
+                ...process.env.NODE_ENV !== undefined && {
                     NODE_ENV: process.env.NODE_ENV
                 },
                 ...this.appEnv,
@@ -658,7 +707,7 @@ copies or substantial portions of the Software.
             // The new bundler is made, its plugins set up and its config resolved, before the running build is closed: a
             // config whose rsbuild hook or plugin throws leaves that build watching the sources, and the bot it started running
             const watch = async ()=>{
-                const { rsbuild } = await this.createBundler('development');
+                const { rsbuild, meocordConfig } = await this.createBundler('development');
                 await rsbuild.initConfigs({
                     action: 'build'
                 });
@@ -667,6 +716,7 @@ copies or substantial portions of the Software.
                 rsbuild.onAfterBuild(({ stats })=>{
                     isRunning = true;
                     if (stats?.hasErrors()) return;
+                    if (!meocordConfig?.bundleDependencies) this.removePackedOutputs();
                     this.latestBuild = stats ? emittedDigest(stats) : undefined;
                     this.restartApp(this.latestBuild);
                 });
@@ -704,11 +754,20 @@ copies or substantial portions of the Software.
                     changed = new Set();
                     for (const file of files)this.logger.log(reloads[file]);
                     if (!rebuilds(files)) return this.restartApp();
-                    // A config that doesn't compile, say mid-edit, leaves the running bot and its build as they are
-                    if (files.has('meocord.config.ts') && !await this.compileConfig({
-                        mode: 'development',
-                        exitOnFailure: false
-                    })) return;
+                    // A config that is refused, as at startup, or doesn't compile, say mid-edit, leaves the running bot and its build
+                    // as they are
+                    if (files.has('meocord.config.ts')) {
+                        const checked = checkSourceConfig();
+                        if ('problem' in checked) {
+                            // One that doesn't load, say mid-edit, is reported as a failed compile is, and watching goes on
+                            if (checked.loadError !== undefined) return this.logger.error(`Failed to compile meocord.config.ts: ${checked.loadError}`);
+                            return reportConfigProblem(checked.problem);
+                        }
+                        if (!await this.compileConfig({
+                            mode: 'development',
+                            exitOnFailure: false
+                        })) return;
+                    }
                     isRunning = false;
                     // The new build restarts the bot, whatever its output: the config it was launched with has changed
                     this.launchedFrom = undefined;
@@ -836,4 +895,4 @@ if (isProcessEntry()) {
     });
 }
 
-export { MeoCordCLI, emittedDigest, stillRunning };
+export { MeoCordCLI, appDirectoryName, emittedDigest, stillRunning };

package/dist/esm/build/load-config.pre-entry.js

@@ -1,12 +1,13 @@
-// Runs before the application's entry, so whatever environment meocord.config loads -- a dotenv
-// import, say -- is in place when the entry's decorators read process.env. Silent when the config
-// is missing or throws: MeoCordFactory.create reports that.
+// Runs before the application's entry and every package it imports, so whatever environment meocord.config loads -- a
+// dotenv import, say -- is in place when the entry's decorators and its packages read process.env. Silent when the
+// config is missing or throws: MeoCordFactory.create reports that.
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { installStackRemapper } from './stack-remap.js'
 import { listenForDevRunnerStop } from '../util/dev-runner.util.js'
-import { BUILD_MODE_KEY, BUNDLE_ENTRY_KEY } from '../util/bundle-entry.util.js'
+import { BUILD_MODE_KEY, BUNDLE_ENTRY_KEY, STARTUP_ERRORS_KEY } from '../util/bundle-entry.util.js'
 import { loadMeoCordConfig } from '../util/meocord-config-loader.util.js'
+import { platformMismatch } from '../util/platform.util.js'
 
 // First, so a restart `meocord start --dev` asks for while the bundle still loads is heard
 listenForDevRunnerStop()
@@ -22,8 +23,20 @@ globalThis[BUILD_MODE_KEY] = process.env.NODE_ENV
 // rather than the directory the build ran in, which the bundle would otherwise carry
 __webpack_public_path__ = `${path.dirname(bundle).replace(/\\/g, '/')}/`
 
+// Before any package loads: a native addon built for another platform would otherwise fail as it is imported, with its
+// own error rather than this one, which names both platforms. In every process, a shard manager's and register's too
+const mismatch = platformMismatch()
+if (mismatch) {
+  // The shape of MeoCord's own error line, without its colours and timestamp, which need packages yet to load
+  process.stderr.write(`[ERROR] [MeoCord] ${mismatch}\n`)
+  process.exit(1)
+}
+
 // Beside the bundle, wherever the bot was started from, by the loader the runtime uses: the same module when meocord is
 // bundled, else a copy of it, and require's cache evaluates the config once either way; the factory reports a failure
 const config = loadMeoCordConfig()
 
+// Before the entry's decorators run, so with 'all' they keep their startup errors for create() to report together
+if (config?.startupErrors === 'all') globalThis[STARTUP_ERRORS_KEY] = 'all'
+
 if (config?.sourceMappedStacks !== false) installStackRemapper(bundle)

package/dist/esm/build/rsbuild-config.js

@@ -2,6 +2,7 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 import { OptionalProbesPlugin } from './optional-probes.js';
 import { RunnableBundlePlugin } from './runnable-bundle.js';
+import { typeExternals } from './typed-externals.js';
 import { prepareModifiedTsConfig } from '../util/tsconfig.util.js';
 
 /**
@@ -11,8 +12,7 @@ import { prepareModifiedTsConfig } from '../util/tsconfig.util.js';
 /**
  * Native accelerators discord.js loads when present and works without. A bundler cannot tell
  * optional from missing, so they stay runtime imports. `node-commonjs` keeps each a `require` at its
- * call site, inside the library's try/catch, where a plain ESM external would hoist an import that
- * throws before the bot starts.
+ * call site, inside the library's try/catch, however the bundle asks for it.
  */ const DISCORD_OPTIONAL_NATIVES = [
     'zlib-sync',
     'bufferutil',
@@ -30,8 +30,8 @@ import { prepareModifiedTsConfig } from '../util/tsconfig.util.js';
     ];
 }
 /**
- * The `optionalExternals` also listed in `externals`, where each becomes a hoisted import that throws
- * at startup when the package is missing, defeating the point of listing it as optional.
+ * The `optionalExternals` also listed in `externals`, where an ESM import of each runs as its importer loads and
+ * throws when the package is missing, defeating the point of listing it as optional; a require stays one either way.
  */ function optionalExternalConflicts(optionalExternals = [], externals = []) {
     return optionalExternals.filter((name)=>externals.some((external)=>typeof external === 'string' ? external === name : external.test(name)));
 }
@@ -91,18 +91,16 @@ import { prepareModifiedTsConfig } from '../util/tsconfig.util.js';
                 const wasmDir = environment.config.output.distPath.wasm;
                 chain.output.webassemblyModuleFilename(path.posix.join(wasmDir, '[contenthash:10].module.wasm'));
                 // `new URL('./file', import.meta.url)` stays a URL relative to the bundle. Through the asset prefix, a disk path,
-                // it would parse as a URL of scheme `c:` on Windows rather than a file: URL
+                // it would parse as a URL of scheme `c:` on Windows rather than a file: URL. import.meta.url itself is left to the
+                // runtime, as import.meta.dirname is, so it names the running bundle rather than the source file on the machine
+                // that built it; the pre-entry records the bundle's own path from it, which a process manager's wrapper in
+                // process.argv[1] would hide
                 chain.module.parser.merge({
                     javascript: {
-                        url: 'new-url-relative'
+                        url: 'new-url-relative',
+                        importMeta: false
                     }
                 });
-                // The pre-entry records the bundle's own path from import.meta.url, which the bundler would otherwise fix at
-                // build time to the pre-entry's source file. In every mode: a process manager such as pm2 starts the bundle
-                // from a wrapper of its own, so process.argv[1] names that wrapper, not the bundle
-                chain.module.rule('meocord-pre-entry').test(CONFIG_PRE_ENTRY).parser({
-                    importMeta: false
-                });
                 // Hoisting modules into one scope renames a class whose name another module also declares, and
                 // MeoCord keys cooldowns and names handlers by class name, so a build keeps each module's own scope
                 chain.optimization.concatenateModules(false);
@@ -111,6 +109,12 @@ import { prepareModifiedTsConfig } from '../util/tsconfig.util.js';
                 chain.optimization.emitOnErrors(false);
                 // Keeps the bundle starting under Node and Bun alike, whatever devtool or dependencies it has.
                 chain.plugin('meocord-runnable-bundle').use(RunnableBundlePlugin);
+                // A package kept out of the bundle loads where its importer runs, after the pre-entry, rather than hoisted above
+                // it; typed here, after autoExternal and the externals are merged
+                const externals = chain.get('externals');
+                if (externals && !options.requireable) chain.externals(typeExternals(Array.isArray(externals) ? externals : [
+                    externals
+                ]));
                 // Says a missing package a dependency only probes for is harmless, and how to silence it
                 chain.plugin('meocord-optional-probes').use(OptionalProbesPlugin);
             },