# Бот на Node.js

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

## Что нужно

- Node.js 18 или новее.
- Секретный ключ с правом `donations:read` в переменной `DONATTY_TOKEN`: [как сохранить](https://developers.donatty.com/quickstart/bot.md#2-сохраните-ключ-в-переменной).

## 1. Сохраните код

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

> **Имя и текст — чужой ввод.**
> Текст и имя донатера — чужой ввод: очищайте перед выводом в чат, оверлей или HTML. Пример заменяет управляющие символы пробелом, чтобы донатер не управлял вашим терминалом.

```js title="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));
}
```

## 2. Запустите

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

```sh
node bot.mjs
```

## Что вы увидите

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

```text
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, один проход — один запрос. Каждая следующая страница — ещё один запрос в счёт [лимита](https://developers.donatty.com/rate-limits.md).
