meocord 4.2.0 → 4.2.1

package/dist/cli.json

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

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, 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,6 +23,15 @@ 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()

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);
             },

package/dist/esm/build/typed-externals.js

@@ -0,0 +1,36 @@
+/**
+ * How a package kept out of the bundle is loaded, by how the bundle asks for it: an ESM `import` becomes a dynamic
+ * `import()` where its importer runs, rather than one hoisted above the pre-entry, so the package loads after the
+ * platform check and after the config has loaded `.env`; a CommonJS `require` stays a `require` at its call site, which
+ * returns the module rather than the promise a dynamic import would.
+ */ function externalType(request, dependencyType) {
+    return `${dependencyType === 'commonjs' ? 'node-commonjs' : 'import'} ${request}`;
+}
+/** Whether an external's result names its own type, as `node-commonjs zlib-sync` does. */ const typed = (result)=>/\s/.test(result);
+/**
+ * The externals with every untyped entry given its type by {@link externalType}: a string or pattern, as `autoExternal`
+ * and `externals` give them, and a function's untyped result. An object's entries are left as they are.
+ */ function typeExternals(items) {
+    return items.map((item)=>{
+        if (typeof item === 'string' || item instanceof RegExp) {
+            const matches = (request)=>typeof item === 'string' ? request === item : item.test(request);
+            return (data, callback)=>{
+                const { request, dependencyType } = data;
+                if (request && matches(request)) return callback(null, externalType(request, dependencyType));
+                callback();
+            };
+        }
+        if (typeof item !== 'function') return item;
+        const original = item;
+        return (data, callback)=>{
+            const finish = (result)=>callback(null, typeof result === 'string' && !typed(result) ? externalType(result, data.dependencyType) : result);
+            // Callback style, as MeoCord's own native externals are, or a promise
+            if (original.length >= 2) {
+                return original(data, (error, result)=>error ? callback(error) : finish(result));
+            }
+            Promise.resolve(original(data)).then(finish, callback);
+        };
+    });
+}
+
+export { externalType, typeExternals };

package/dist/esm/common/cooldown-store.js

@@ -254,9 +254,17 @@
             };
         });
     }
-    /** Drops the keys whose calls have all left their window, once a minute from the store's first call. */ startSweeping() {
+    /**
+   * Drops the keys whose calls have all left their window, once a minute from a call, until a sweep leaves none: an
+   * idle store then holds no timer, so one nothing references is collected, and its next call starts the sweep again.
+   */ startSweeping() {
         if (this.sweeper) return;
-        this.sweeper = setInterval(()=>sweep(this.calls, Date.now()), SWEEP_INTERVAL_MS);
+        this.sweeper = setInterval(()=>{
+            sweep(this.calls, Date.now());
+            if (this.calls.size > 0) return;
+            clearInterval(this.sweeper);
+            this.sweeper = undefined;
+        }, SWEEP_INTERVAL_MS);
         // A cooldown must never be what keeps a stopping bot alive.
         this.sweeper.unref?.();
     }

package/dist/esm/common/errors.js

@@ -1,4 +1,5 @@
 import { renderText } from './meocord-text.js';
+import { sharedKey } from '../util/shared-state.util.js';
 
 /**
  * Thrown by a guard to deny a call and tell the user why.
@@ -330,5 +331,29 @@ import { renderText } from './meocord-text.js';
         this.name = 'CooldownStoreError';
     }
 }
+/**
+ * Makes `instanceof` hold for an error from either build of this meocord version, ES module or CommonJS: the class's
+ * prototype carries a brand both builds share, which `instanceof` on the class itself checks. A subclass, such as an
+ * app's own `UserError`, keeps the usual check, so it still matches only its own instances.
+ */ function brand(error, name) {
+    const key = sharedKey(`error:${name}`);
+    Object.defineProperty(error.prototype, key, {
+        value: true
+    });
+    Object.defineProperty(error, Symbol.hasInstance, {
+        value (value) {
+            if (this !== error) return Function.prototype[Symbol.hasInstance].call(this, value);
+            return (typeof value === 'object' || typeof value === 'function') && value !== null && key in value;
+        }
+    });
+}
+// Named as written, since a minifier may rename the classes themselves
+brand(GuardDeniedError, 'GuardDeniedError');
+brand(UserError, 'UserError');
+brand(CommandNotFoundError, 'CommandNotFoundError');
+brand(ValidationError, 'ValidationError');
+brand(MessageUsageError, 'MessageUsageError');
+brand(CooldownError, 'CooldownError');
+brand(CooldownStoreError, 'CooldownStoreError');
 
 export { CommandNotFoundError, CooldownError, CooldownStoreError, GuardDeniedError, MessageUsageError, UserError, ValidationError, cooldownMessage, cooldownStoreMessage, cooldownText, usageHeading };

package/dist/esm/common/meocord-text.js

@@ -1,5 +1,6 @@
 import { fillPlaceholders, pluralForm, lookup, languageOf, LOCALE_CHAIN, CATALOGS } from './translator.js';
 import { MEOCORD_MESSAGES } from './meocord-messages.js';
+import { shared } from '../util/shared-state.util.js';
 
 const hasCatalogs = (translator)=>translator !== undefined && CATALOGS in translator && LOCALE_CHAIN in translator;
 const ENGLISH = 'en-US';
@@ -31,16 +32,17 @@ const ENGLISH = 'en-US';
     return english();
 }
 const lists = new Map();
-/** A list in a locale's words: "a, b, or c" in en-US, or, for a unit, "a, b, c". */ function listIn(locale, style, items) {
-    let format = lists.get(`${locale} ${style}`);
-    if (!format) lists.set(`${locale} ${style}`, format = new Intl.ListFormat(locale, {
-        type: style === 'or' ? 'disjunction' : 'unit'
+/** An `or` list in a locale's words, such as "a, b, or c" in en-US. */ function orListIn(locale, items) {
+    let format = lists.get(locale);
+    if (!format) lists.set(locale, format = new Intl.ListFormat(locale, {
+        type: 'disjunction'
     }));
     return format.format(items);
 }
 /**
- * A text in `locale`, as {@link findText} finds it. A list in MeoCord's English is joined with its `joiner`, a comma
- * unless given; in an app's catalog, in the words of the locale that has it.
+ * A text in `locale`, as {@link findText} finds it. An `or` list in an app's catalog reads in the words of the locale
+ * that has it; any other list is joined with its `joiner`, a comma unless given, as Intl's `unit` lists join with
+ * nothing in zh-CN and with a space in ja.
  */ function renderText(translator, locale, text) {
     const found = findText(translator, locale, text.key);
     if (!found) return text.fallback ?? text.key;
@@ -49,14 +51,15 @@ const lists = new Map();
         if (!Object.hasOwn(params, name)) return whole;
         const value = params[name];
         if (typeof value !== 'object') return String(value);
-        if ('list' in value) return found.own ? listIn(found.locale, value.style, value.list) : value.list.join(value.joiner ?? ', ');
+        if ('list' in value) return found.own && value.style === 'or' ? orListIn(found.locale, value.list) : value.list.join(value.joiner ?? ', ');
         return renderText(translator, locale, value);
     });
 }
 /** Renders texts in one locale through one translator: a word or number as it is, a text in the locale's words. */ function textRenderer(translator, locale) {
     return (text)=>typeof text !== 'object' ? String(text) : 'list' in text ? text.list.join(text.joiner ?? ', ') : renderText(translator, locale, text);
 }
-const translators = new WeakMap();
+// Shared by both builds of this version, so either answers in the app's language
+const translators = shared('clientTranslators', ()=>new WeakMap());
 /** Records the translator of the app a client's interactions and messages come to. */ function registerClientTranslator(client, translator) {
     if (translator) translators.set(client, translator);
     else translators.delete(client);