first commit

src/core/registry.js

@@ -0,0 +1,84 @@
+export const SCOPES = ['all', 'private', 'business'];
+
+/** Telegram принимает в setMyCommands только [a-z0-9_]{1,32} */
+const TELEGRAM_COMMAND = /^[a-z0-9_]{1,32}$/;
+
+export class CommandRegistry {
+  /** @type {Map<string, object>} триггер (имя или алиас) -> команда */
+  #triggers = new Map();
+  /** @type {object[]} */
+  #commands = [];
+
+  register(definition, source = '<inline>') {
+    const command = normalize(definition, source);
+
+    for (const trigger of [command.command, ...command.aliases]) {
+      const taken = this.#triggers.get(trigger);
+      if (taken) {
+        throw new Error(
+          `Конфликт триггеров: "${trigger}" из ${source} уже занят командой "${taken.command}" (${taken.source}).`,
+        );
+      }
+      this.#triggers.set(trigger, command);
+    }
+
+    this.#commands.push(command);
+    return command;
+  }
+
+  resolve(trigger) {
+    return this.#triggers.get(trigger.toLowerCase());
+  }
+
+  /** Все команды в порядке регистрации. */
+  list() {
+    return [...this.#commands];
+  }
+
+  /** Что показываем в /help. */
+  visible() {
+    return this.#commands.filter((cmd) => !cmd.hidden);
+  }
+
+  /** Что уходит в setMyCommands: без скрытых, админских и нелатинских алиасов. */
+  forTelegram() {
+    return this.#commands
+      .filter((cmd) => !cmd.hidden && !cmd.adminOnly && TELEGRAM_COMMAND.test(cmd.command))
+      .map((cmd) => ({ command: cmd.command, description: cmd.description }));
+  }
+}
+
+function normalize(definition, source) {
+  if (!definition || typeof definition !== 'object') {
+    throw new Error(`${source}: файл команды должен экспортировать объект по умолчанию.`);
+  }
+
+  const { command, aliases = [], description = '', scope = 'all', adminOnly = false, hidden = false, handler } = definition;
+
+  if (typeof command !== 'string' || !command.trim()) {
+    throw new Error(`${source}: не задано поле "command".`);
+  }
+  if (command.startsWith('/')) {
+    throw new Error(`${source}: имя команды указывается без слэша — "${command.slice(1)}", а не "${command}".`);
+  }
+  if (typeof handler !== 'function') {
+    throw new Error(`${source}: поле "handler" должно быть функцией.`);
+  }
+  if (!SCOPES.includes(scope)) {
+    throw new Error(`${source}: неизвестный scope "${scope}". Допустимо: ${SCOPES.join(', ')}.`);
+  }
+  if (!Array.isArray(aliases) || aliases.some((alias) => typeof alias !== 'string')) {
+    throw new Error(`${source}: "aliases" должен быть массивом строк.`);
+  }
+
+  return {
+    command: command.toLowerCase(),
+    aliases: aliases.map((alias) => alias.toLowerCase()),
+    description,
+    scope,
+    adminOnly: Boolean(adminOnly),
+    hidden: Boolean(hidden),
+    handler,
+    source,
+  };
+}