meocord 4.1.2 → 4.2.1

package/dist/cjs/_shared/{translate-error-BnM8FbSH.cjs → translate-error-BUAR1WYG.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-var controller_decorator = require('./controller.decorator-BywwkU9O.cjs');
+var controller_decorator = require('./controller.decorator-XKMlcUZz.cjs');
 var discord_js = require('discord.js');
 
-/** The longest customId Discord accepts. */ const MAX_CUSTOM_ID_LENGTH = 100;
+const logger = new controller_decorator.Logger('Route');
 const PLACEHOLDER = /\{(\w+)(?::([^}/]*))?}/g;
 /** Encodes the characters that would end a param's segment, or read as an encoding, in a customId. */ const encodeSegment = (value)=>value.replace(/%/g, '%25').replace(/\//g, '%2F');
 /**
@@ -16,6 +16,10 @@ const PLACEHOLDER = /\{(\w+)(?::([^}/]*))?}/g;
             decodeSegment(value)
         ]));
 }
+/** The segment types whose value is text, which `build` takes only as a string. */ const TEXT_TYPES = new Set([
+    'snowflake',
+    'uuid'
+]);
 /**
  * Makes a typed route from a customId pattern, so one declaration serves the handler and the ids that reach it.
  *
@@ -28,7 +32,8 @@ const PLACEHOLDER = /\{(\w+)(?::([^}/]*))?}/g;
  * fails to compile, and a typed param takes a value of its type.
  *
  * @param pattern - The customId pattern, where `{name}` captures one `/`-separated segment and `{name:int}` a
- *   typed one.
+ *   typed one. A param's name is ASCII letters, digits and _: a brace pair such as `{café}` is literal text, and is
+ *   warned about.
  * @returns A route whose `build` takes a value for each param.
  * @throws Error when the pattern cannot be read, as `@Command` would throw for it.
  *
@@ -50,9 +55,12 @@ const PLACEHOLDER = /\{(\w+)(?::([^}/]*))?}/g;
  *
  * @group Utilities
  * @see {@link Route}
- * @see {@link https://meocord.dev/docs/4.1/components | Buttons, selects and modals}
+ * @see {@link https://meocord.dev/docs/4.2/components | Buttons, selects and modals}
  */ function route(pattern) {
     const { params, types } = controller_decorator.createRegexFromPattern(pattern);
+    const braces = controller_decorator.literalBraces(pattern);
+    // Once per pattern, as a route made inside a handler is made on every call
+    if (braces) controller_decorator.warnOnce(logger, `Pattern "${pattern}": ${braces}`);
     const names = new Set(params);
     const build = (values = {})=>{
         const unknown = Object.keys(values).filter((name)=>!names.has(name));
@@ -62,6 +70,11 @@ const PLACEHOLDER = /\{(\w+)(?::([^}/]*))?}/g;
             const value = Object.hasOwn(values, name) ? values[name] : undefined;
             const type = Object.hasOwn(types, name) ? types[name] : undefined;
             if (value === undefined || value === null) throw new TypeError(`route('${pattern}').build() needs a value for ${placeholder}.`);
+            // A snowflake's or uuid's value is its text: a number for a snowflake may have lost digits before it got here
+            if (type && TEXT_TYPES.has(type) && typeof value !== 'string') {
+                const lost = type === 'snowflake' ? ' A number may have lost digits already: pass the ID as text, such as user.id.' : '';
+                throw new TypeError(`route('${pattern}').build() got the ${typeof value} ${String(value)} for ${placeholder}, which takes its value as a string.${lost}`);
+            }
             const text = String(value);
             if (text === '') throw new TypeError(`route('${pattern}').build() got an empty {${name}}, which no customId segment can hold.`);
             // A typed segment must read back as the value it was built from, or the route could never match it
@@ -71,8 +84,9 @@ const PLACEHOLDER = /\{(\w+)(?::([^}/]*))?}/g;
             }
             return encodeSegment(text);
         });
-        if (id.length > MAX_CUSTOM_ID_LENGTH) {
-            throw new RangeError(`route('${pattern}').build() made a customId of ${id.length} characters, over Discord's ${MAX_CUSTOM_ID_LENGTH}: "${id}".`);
+        if (id === '') throw new RangeError(`route('${pattern}').build() made an empty customId; Discord's customIds are 1 to ${controller_decorator.MAX_CUSTOM_ID_LENGTH} characters.`);
+        if (id.length > controller_decorator.MAX_CUSTOM_ID_LENGTH) {
+            throw new RangeError(`route('${pattern}').build() made a customId of ${id.length} characters, over Discord's ${controller_decorator.MAX_CUSTOM_ID_LENGTH}: "${id}".`);
         }
         return id;
     };
@@ -139,7 +153,7 @@ const PLACEHOLDER = /\{(\w+)(?::([^}/]*))?}/g;
  * @group Utilities
  * @category Localisation
  * @see {@link createTranslator}
- * @see {@link https://meocord.dev/docs/4.1/localisation | Localisation}
+ * @see {@link https://meocord.dev/docs/4.2/localisation | Localisation}
  */ function translateError(error, t, target) {
     const locale = target instanceof discord_js.BaseInteraction ? controller_decorator.interactionLocale(target) : target instanceof discord_js.Message ? controller_decorator.messageLocale(target) : target;
     return errorText(error, t, locale);

package/dist/cjs/common/index.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var controller_decorator = require('../_shared/controller.decorator-BywwkU9O.cjs');
+var controller_decorator = require('../_shared/controller.decorator-XKMlcUZz.cjs');
 require('reflect-metadata');
-var translateError = require('../_shared/translate-error-BnM8FbSH.cjs');
-var shardedCooldownStore = require('../_shared/sharded-cooldown-store-B65iaiAy.cjs');
+var translateError = require('../_shared/translate-error-BUAR1WYG.cjs');
+var shardedCooldownStore = require('../_shared/sharded-cooldown-store-CsJJyCZd.cjs');
 require('../enum/index.cjs');
 require('discord.js');
 require('path');
@@ -150,7 +150,7 @@ const assigned = {};
  *
  * @group Utilities
  * @see {@link ExecutionContext}
- * @see {@link https://meocord.dev/docs/4.1/guards | Guards}
+ * @see {@link https://meocord.dev/docs/4.2/guards | Guards}
  */ function createMetadata(description) {
     const key = Symbol(description);
     const decorator = (value)=>function(target, propertyKey) {