forked from c-fu/arah2
- src/i18n/strings.ts: single copy source of truth, en + ms identical key-sets, clinical/honest start + privacy copy, pickLocale fallback rule - /start /mula, /help, /privacy /privasi handlers: plain text replies with link previews disabled, zero menu/button surface (D-02, grep-gated) - createBot(env) factory registers exactly the phase command stack - scripts/register-commands.mjs: one-time setMyCommands, two scopes (default + language_code ms), descriptions derived from helpMenu — no inline copy, no future-command stubs (D-03/D-05) - test/commands.test.mjs: CS1-CS6 gates — locale parity, pickLocale matrix, PRIV-01 copy gate vs never-facts + TTL wording, D-02 structural grep, D-03 menu gap-freedom, D-04 alias completeness (27 passing)
92 lines
3.8 KiB
JavaScript
92 lines
3.8 KiB
JavaScript
#!/usr/bin/env node
|
|
/*
|
|
* register-commands.mjs — one-time setMyCommands registration (D-03, D-04, D-17).
|
|
* -------------------------------------------------------------------------------
|
|
* Registers the bot's persistent command menu in two scopes:
|
|
* 1. default scope — English /help and /privacy descriptions
|
|
* 2. default + language_code "ms" — Malay descriptions for ms users
|
|
*
|
|
* D-03: the menu lists ONLY commands that exist in this phase (/help,
|
|
* /privacy) — no stub entries reserved for future commands. There are
|
|
* exactly two fetch calls below, one per scope.
|
|
*
|
|
* D-05 (single copy source): the descriptions are not inline here — they
|
|
* are derived from src/i18n/strings.ts `helpMenu` lines ("/cmd — text"),
|
|
* the same text /help replies with, so reply and registered menu cannot
|
|
* drift apart.
|
|
*
|
|
* Secrets stay secret (T-02-04): BOT_TOKEN is read from bot/.dev.vars
|
|
* (never committed, D-15) and is never echoed — only the API response's
|
|
* ok/result fields are printed.
|
|
*/
|
|
import { readFileSync } from "node:fs";
|
|
import path from "node:path";
|
|
import { fileURLToPath } from "node:url";
|
|
import { strings } from "../src/i18n/strings.ts";
|
|
|
|
/* ————— configuration (D-15: local secrets from gitignored .dev.vars) ————— */
|
|
|
|
function readDevVars() {
|
|
const devVarsPath = path.join(fileURLToPath(new URL(import.meta.url)), "..", "..", ".dev.vars");
|
|
let raw = "";
|
|
try {
|
|
raw = readFileSync(devVarsPath, "utf8");
|
|
} catch {
|
|
return {};
|
|
}
|
|
const vars = {};
|
|
for (const line of raw.split("\n")) {
|
|
const trimmed = line.trim();
|
|
if (trimmed.length === 0 || trimmed.startsWith("#")) continue;
|
|
const eq = trimmed.indexOf("=");
|
|
if (eq === -1) continue;
|
|
vars[trimmed.slice(0, eq).trim()] = trimmed.slice(eq + 1).trim();
|
|
}
|
|
return vars;
|
|
}
|
|
|
|
const token = process.env.BOT_TOKEN ?? readDevVars().BOT_TOKEN;
|
|
if (!token) {
|
|
console.error(
|
|
"BOT_TOKEN missing — copy bot/.dev.vars.example to bot/.dev.vars (gitignored) and paste your @BotFather token.",
|
|
);
|
|
process.exit(1);
|
|
}
|
|
|
|
/* ————— menu derived from the strings module (D-03/D-05, gap-free) ————— */
|
|
|
|
/** Extract the `/cmd — description` entries from a locale's helpMenu. */
|
|
function menuFor(locale) {
|
|
const lines = strings[locale].helpMenu.split("\n");
|
|
return ["help", "privacy"].map((command) => {
|
|
const marker = `/${command} — `;
|
|
const line = lines.find((l) => l.startsWith(marker));
|
|
if (line === undefined) {
|
|
throw new Error(`helpMenu for "${locale}" is missing its /${command} line (D-03 copy drift)`);
|
|
}
|
|
return { command, description: line.slice(marker.length).trim() };
|
|
});
|
|
}
|
|
|
|
/* ————— exactly two API calls: default scope, then the ms scope (D-03/D-04) ————— */
|
|
|
|
const API = `https://api.telegram.org/bot${token}/setMyCommands`;
|
|
const JSON_HEADERS = { "content-type": "application/json" };
|
|
|
|
const defaultPayload = { commands: menuFor("en"), bot_command_scope: { type: "default" } };
|
|
const msPayload = { commands: menuFor("ms"), bot_command_scope: { type: "default" }, language_code: "ms" };
|
|
|
|
const defaultRes = await fetch(API, { method: "POST", headers: JSON_HEADERS, body: JSON.stringify(defaultPayload) });
|
|
const defaultBody = await defaultRes.json();
|
|
console.log(`default scope -> ok:${defaultBody.ok} result:${JSON.stringify(defaultBody.result ?? null)}`);
|
|
|
|
const msRes = await fetch(API, { method: "POST", headers: JSON_HEADERS, body: JSON.stringify(msPayload) });
|
|
const msBody = await msRes.json();
|
|
console.log(`ms scope -> ok:${msBody.ok} result:${JSON.stringify(msBody.result ?? null)}`);
|
|
|
|
if (!defaultBody.ok || !msBody.ok) {
|
|
const firstError = !defaultBody.ok ? defaultBody : msBody;
|
|
console.error(`setMyCommands failed: ${firstError.error_code ?? "?"} ${firstError.description ?? "unknown error"}`);
|
|
process.exit(1);
|
|
}
|