Перейти к содержимому

Бот на Node.js

Бот раз в 5 секунд запрашивает новые донаты и печатает те, что можно показать на стриме. Один файл, без библиотек.

  • Node.js 18 или новее.
  • Секретный ключ с правом donations:read в переменной DONATTY_TOKEN: как сохранить.

Скопируйте код в файл bot.mjs.

bot.mjs
const API = "https://api.donatty.com";
const TOKEN = process.env.DONATTY_TOKEN;
if (!TOKEN) {
console.error("Задайте DONATTY_TOKEN: секретный ключ с правом donations:read");
process.exit(1);
}
const SHOW = new Set(["NONE", "PASSED"]);
const clean = text => String(text ?? "").replace(/[\u0000-\u001f\u007f-\u009f\u2028\u2029\u202a-\u202e\u2066-\u2069]/g, " "); // чужой ввод: управляющие символы → пробел
const shown = new Set(); // id уже показанных донатов
const waiting = new Map(); // id → createdAt донатов, по которым модерация ещё не решила
let boundary = new Date(); // читаем донаты, созданные с момента запуска
let failures = 0;
async function get(url) {
const res = await fetch(url, { headers: { Authorization: `Bearer ${TOKEN}` } });
if (res.ok) return res.json();
const problem = await res.json().catch(() => ({}));
if (res.status === 401 || res.status === 403) {
console.error(res.status, problem.code, problem.type);
process.exit(1);
}
const error = new Error(`${res.status} ${problem.code ?? ""}`.trim());
error.retryAfter = res.status === 429 ? Number(res.headers.get("Retry-After") ?? 5) : null;
throw error;
}
// Один проход: все страницы окна с одними и теми же параметрами.
async function readWindow() {
const items = [];
let cursor = null;
do {
const url = `${API}/v1/donations?limit=100&since=${boundary.toISOString()}`
+ (cursor ? `&cursor=${encodeURIComponent(cursor)}` : "");
const page = await get(url);
items.push(...page.items);
cursor = page.nextCursor;
} while (cursor);
return items;
}
function handle(items) {
const seen = new Set();
for (const d of items.reverse()) { // от старых к новым
seen.add(d.id);
if (d.moderation.status === "PENDING") {
waiting.set(d.id, d.createdAt);
continue;
}
waiting.delete(d.id);
if (SHOW.has(d.moderation.status) && !shown.has(d.id)) {
shown.add(d.id);
const fee = d.feeCompensation ? ` (+${d.feeCompensation.value} ${d.feeCompensation.currency} за комиссию)` : "";
console.log(`${clean(d.donorName)} — ${d.amount.value} ${d.amount.currency}${fee}: ${clean(d.message)}`);
}
}
for (const id of waiting.keys()) if (!seen.has(id)) waiting.delete(id);
if (items.length > 0) {
const newest = Math.max(...items.map(d => Date.parse(d.createdAt))) - 60_000;
const oldestWaiting = Math.min(Infinity, ...[...waiting.values()].map(Date.parse));
boundary = new Date(Math.max(boundary, Math.min(newest, oldestWaiting)));
}
}
while (true) {
let pause = 5;
try {
handle(await readWindow());
failures = 0;
} catch (error) {
failures += 1;
pause = error.retryAfter ?? Math.min(2 ** failures, 60);
console.error(error.message);
}
await new Promise(resolve => setTimeout(resolve, pause * 1000));
}

В том же окне терминала, где вы сохранили ключ, перейдите в папку с файлом и выполните:

Терминал
node bot.mjs

Бот показывает донаты, которые пришли после запуска, поэтому сначала в терминале пусто. Каждый новый донат, который можно показать на стриме, появится строкой:

Alex — 500.00 RUB (+27.00 RUB за комиссию): Thanks for the stream!

Если донатер доплатил за комиссию, доплата показана в скобках; без доплаты скобок нет.

Проверить бота можно только настоящим донатом: «Тест на стриме» в кабинете показывает оповещение, но доната не создаёт, и в API его нет.

  • Бот читает донаты без фильтра модерации: так не теряется донат, который сначала ждал решения, а потом прошёл. Ожидающие PENDING он запоминает и перечитывает, пока модерация не решит.
  • Выводятся только NONE и PASSED. BLOCKED и неизвестный статус бот не показывает.
  • Бот читает все страницы, пока nextCursor не станет null. Следующий проход он начинает с более раннего из двух моментов: создание самого старого доната со статусом PENDING или создание самого нового доната минус минута. Уже показанные донаты пропускает по id.
  • После 429 бот ждёт Retry-After. На 401 и 403 бот останавливается и печатает код ошибки со ссылкой на её страницу. Там сказано, что сделать с ключом. На 5xx и сетевых ошибках повторяет с паузой 2, 4, 8… секунд, не дольше минуты.
  • Сумма — строка value и код валюты. Не переводите её в число с плавающей точкой.
  • feeCompensation — доплата за комиссию в той же форме и валюте, или null; amount остаётся основной суммой.
  • После перезапуска бот начинает с текущего момента: что показано раньше, он не помнит.
  • Донат, который появился в списке больше чем через минуту после своего создания, бот не увидит. Так бывает с донатами Donation Alerts после обрыва связи.
  • Давно отклонённый донат, который вы вернули кнопкой «Повторить на стриме», бот тоже не увидит.
  • Замените console.log на отправку в чат или в оверлей. Имя и текст перед этим очистите.
  • Пока новых донатов меньше 100, один проход — один запрос. Каждая следующая страница — ещё один запрос в счёт лимита.