@itd-api/captcha 0.1.0

package/dist/index.js

@@ -0,0 +1,675 @@
+//#region src/errors.ts
+/** Почему не удалось получить токен. */
+const CaptchaFailure = Object.freeze({
+	/** Драйвер браузера не установлен. */
+	DriverMissing: "driver-missing",
+	/** Браузер не запустился: нет исполняемого файла, нет дисплея, отказ песочницы. */
+	LaunchFailed: "launch-failed",
+	/** Браузер или страница закрылись, пока решался виджет. */
+	BrowserClosed: "browser-closed",
+	/** Виджет не отдал токен за отведённое время. */
+	Timeout: "timeout",
+	/** Сам виджет сообщил об ошибке — код лежит в `widgetCode`. */
+	WidgetError: "widget-error"
+});
+/**
+* Ошибка получения токена капчи.
+*
+* Причина в {@link CaptchaError.reason} определяет, что с ошибкой делать: отсутствие драйвера
+* чинится установкой, таймаут — повтором, а ошибка виджета повтором не лечится. Поле
+* {@link CaptchaError.type} говорит, чей именно виджет решался, — оно есть не у всех ошибок
+* (запуск браузера происходит до выбора виджета).
+*/
+var CaptchaError = class extends Error {
+	reason;
+	/** Какой провайдер решался в момент ошибки. */
+	type;
+	/**
+	* Код ошибки виджета, если он его сообщил.
+	*
+	* Для Cloudflare самые частые: `110200` — домен не разрешён для этого ключа, `300***`
+	* и `600***` — внутренние сбои виджета, лечатся повтором.
+	*/
+	widgetCode;
+	constructor(reason, message, options = {}) {
+		super(message);
+		this.name = "CaptchaError";
+		this.reason = reason;
+		this.type = options.type;
+		this.widgetCode = options.widgetCode;
+	}
+};
+//#endregion
+//#region src/launch.ts
+/**
+* Аргументы запуска Chromium.
+*
+* Подмены `User-Agent` здесь нет намеренно: заявленная версия браузера расходилась бы
+* с реальным движком, а такое расхождение само по себе служит признаком автоматизации.
+* Остаются безопасные общие флаги. Отключение sandbox вынесено в явную настройку:
+* удалённый код виджета исполняется в браузере, и ослаблять его изоляцию по умолчанию нельзя.
+*/
+const DEFAULT_ARGS = ["--disable-dev-shm-usage", "--disable-blink-features=AutomationControlled"];
+/**
+* Драйверы в порядке предпочтения.
+*
+* `patchright` впереди намеренно: он ставит собственную сборку Chromium, и та проходит
+* виджет там, где сборка из свежего Playwright уже нет. Если стоит только `playwright`,
+* ничего не меняется — берётся он.
+*/
+const DRIVERS = [
+	"patchright",
+	"playwright",
+	"playwright-core"
+];
+/**
+* Как выглядит имя пакета драйвера.
+*
+* Имя приходит извне и уезжает в динамический импорт, поэтому путями и относительными
+* адресами быть не должно — только имя пакета.
+*/
+const DRIVER_NAME = /^(@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*$/i;
+/**
+* Драйверы, которые сами приводят аргументы запуска в порядок.
+*
+* Им ничего не подмешивается: набор флагов у них выверен, а лишний флаг — такой же след,
+* как и недостающий.
+*/
+const SELF_TUNED_DRIVERS = /* @__PURE__ */ new Set(["patchright"]);
+function isModuleNotFound(error) {
+	const code = error?.code;
+	return code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND";
+}
+/**
+* Подключает драйвер браузера.
+*
+* Импорт динамический: драйвер объявлен необязательной одноранговой зависимостью,
+* поэтому его может не быть вовсе. Названный явно берётся один, без перебора: молча
+* подставить вместо него другой значило бы проверить не то, что просили.
+*/
+async function loadDriver(requested) {
+	const wanted = requested ? [requested] : DRIVERS;
+	for (const name of wanted) try {
+		return {
+			driver: name,
+			module: await import(
+				/* @vite-ignore */
+				name
+)
+		};
+	} catch (error) {
+		if (!isModuleNotFound(error)) throw error;
+	}
+	throw new CaptchaError(CaptchaFailure.DriverMissing, requested ? `Драйвер ${requested} не установлен.` : "Не найден драйвер браузера. Установите его командой: npm i patchright && npx patchright install chromium. Либо передайте свой запуск браузера через параметр launch.");
+}
+/** Собирает параметры запуска, не поднимая браузер. @internal */
+function resolveLaunchOptions(options, driver = "") {
+	return {
+		headless: options.headless ?? false,
+		args: [
+			...SELF_TUNED_DRIVERS.has(driver) ? [] : DEFAULT_ARGS,
+			...options.disableSandbox ? ["--no-sandbox"] : [],
+			...options.args ?? []
+		],
+		...options.executablePath ? { executablePath: options.executablePath } : {},
+		...options.channel ? { channel: options.channel } : {},
+		...options.proxy ? { proxy: options.proxy } : {}
+	};
+}
+/**
+* Поднимает браузер по настройкам.
+*
+* Тем же путём, что и солверы: те же флаги, тот же порядок драйверов. Пригодится, чтобы
+* поднять браузер один раз на несколько токенов и передать его в `browser`, — и чтобы
+* проверять связки драйвера и сборки ровно в том виде, в каком их поднимает пакет.
+*/
+async function launchBrowser(options) {
+	if (options.launch) return options.launch();
+	if (options.driver !== void 0 && !DRIVER_NAME.test(options.driver)) throw new TypeError(`driver должен быть именем пакета, получено: ${options.driver}`);
+	const { driver, module: { chromium } } = await loadDriver(options.driver);
+	const launchOptions = resolveLaunchOptions(options, driver);
+	try {
+		return await chromium.launch(launchOptions);
+	} catch (error) {
+		const hint = launchOptions.headless === false ? " Если это сервер без графической оболочки, запустите процесс через xvfb-run -a." : "";
+		throw new CaptchaError(CaptchaFailure.LaunchFailed, `Не удалось запустить браузер: ${error instanceof Error ? error.message : String(error)}.${hint}`);
+	}
+}
+//#endregion
+//#region src/options.ts
+/** Базовый URL сайта итд.com. Домен записан в punycode: `итд.com`. */
+const DEFAULT_ORIGIN = "https://xn--d1ah4a.com";
+/**
+* Приводит адрес к корню и проверяет его пригодность.
+*
+* Виджет привязан к домену, а не к пути: адрес приводится к `URL.origin`, чтобы перехват навигации
+* совпал с ним ровно один раз.
+*/
+function resolveOrigin(origin, field) {
+	let parsed;
+	try {
+		parsed = new URL(origin);
+	} catch {
+		throw new TypeError(`${field} должен быть абсолютным URL, получено: ${origin}`);
+	}
+	if (parsed.protocol !== "https:" && parsed.protocol !== "http:") throw new TypeError(`${field} должен быть http или https, получено: ${parsed.protocol}`);
+	if (parsed.username || parsed.password || parsed.search || parsed.hash) throw new TypeError(`${field} не должен содержать логин, пароль, параметры запроса или фрагмент`);
+	return parsed.origin;
+}
+/**
+* Проверяет общие настройки и подставляет умолчания.
+*
+* @throws {TypeError} при некорректных значениях
+*/
+function resolveOptions(options) {
+	if (typeof options !== "object" || options === null || Array.isArray(options)) throw new TypeError("options должен быть объектом");
+	const timeout = options.timeout ?? 6e4;
+	const attempts = options.attempts ?? 2;
+	const theme = options.theme ?? "auto";
+	if (!Number.isFinite(timeout) || timeout <= 0) throw new TypeError(`timeout должен быть положительным числом, получено: ${timeout}`);
+	if (!Number.isInteger(attempts) || attempts < 1) throw new TypeError(`attempts должен быть целым числом от 1, получено: ${attempts}`);
+	if (theme !== "auto" && theme !== "light" && theme !== "dark") throw new TypeError("theme должен быть 'auto', 'light' или 'dark'");
+	for (const [name, value] of [["headless", options.headless], ["disableSandbox", options.disableSandbox]]) if (value !== void 0 && typeof value !== "boolean") throw new TypeError(`${name} должен быть boolean`);
+	for (const [name, value] of [["driver", options.driver], ["channel", options.channel]]) if (value !== void 0 && (typeof value !== "string" || value.trim() === "")) throw new TypeError(`${name} должен быть непустой строкой`);
+	if (options.logger !== void 0 && typeof options.logger !== "function") throw new TypeError("logger должен быть функцией");
+	if (options.contextOptions !== void 0 && (typeof options.contextOptions !== "object" || options.contextOptions === null || Array.isArray(options.contextOptions))) throw new TypeError("contextOptions должен быть объектом");
+	if (options.launch !== void 0 && typeof options.launch !== "function") throw new TypeError("launch должен быть функцией");
+	if (options.args !== void 0 && (!Array.isArray(options.args) || options.args.some((argument) => typeof argument !== "string"))) throw new TypeError("args должен быть массивом строк");
+	return {
+		...options,
+		origin: resolveOrigin(options.origin ?? "https://xn--d1ah4a.com", "origin"),
+		theme,
+		timeout,
+		attempts
+	};
+}
+/** Требует непустую строку: общая проверка для настроек провайдеров. @internal */
+function requireText(value, field) {
+	if (typeof value !== "string" || value.trim() === "") throw new TypeError(`${field} должен быть непустой строкой`);
+	return value;
+}
+//#endregion
+//#region src/html.ts
+/**
+* Сборка страницы, на которой живёт виджет.
+*
+* Страница отдаётся вместо настоящей — по адресу целевого сайта, через перехват навигации.
+* Благодаря этому `document.location.origin` для виджета настоящий, и привязка ключа
+* к домену не нарушается, а форма входа и пароль в браузере не участвуют.
+*
+* Каркас общий для всех провайдеров: контейнер `#widget` известного размера, от которого
+* общий цикл отсчитывает координаты клика. Различия провайдеров — в `head` и `body`.
+*/
+/** Отступ контейнера от края окна, px. Виджету нужно место, чтобы раскрыть карточку. */
+const WIDGET_MARGIN = 40;
+/**
+* Готовит значение к вставке в инлайновый скрипт или атрибут.
+*
+* Одного `JSON.stringify` мало: кавычки он экранирует, а `<\/script>` — нет, и такая
+* последовательность закрывает тег независимо от того, внутри строки она или нет.
+* Экранированный `<` разбирается движком как обычный символ, но парсер HTML его уже не видит.
+*/
+function embed(value) {
+	return JSON.stringify(value).replace(/</g, "\\u003c");
+}
+/** Собирает страницу с одним виджетом. */
+function buildWidgetPage(parts) {
+	return `<!doctype html>
+<html lang="ru">
+<head>
+<meta charset="utf-8">
+<title>${parts.title}</title>
+<style>
+  html, body { margin: 0; padding: 0; background: #fff; }
+  #widget {
+    width: ${parts.width}px;
+    height: ${parts.height}px;
+    margin: ${WIDGET_MARGIN}px;${parts.widgetStyle ?? ""}
+  }
+</style>
+${parts.head ?? ""}
+</head>
+<body>
+${parts.body}
+</body>
+</html>`;
+}
+//#endregion
+//#region src/types.ts
+/** Провайдер капчи — теми же именами, какими его называет сервер итд.com. */
+const CaptchaType = Object.freeze({
+	/** Собственная капча ИТД: карточка «Я не робот» в iframe с `captcha.итд.com`. */
+	Itd: "itd",
+	/** Cloudflare Turnstile. */
+	Cloudflare: "cloudflare"
+});
+//#endregion
+//#region src/providers/itd.ts
+/** Базовый адрес виджета собственной капчи ИТД. Домен в punycode: `captcha.итд.com`. */
+const DEFAULT_CAPTCHA_ORIGIN = "https://captcha.xn--d1ah4a.com";
+/**
+* Публичный ключ виджета собственной капчи ИТД.
+*
+* Как и ключ Turnstile, он публичный и привязан к домену итд.com: виджет отдаёт его браузеру
+* каждому посетителю.
+*/
+const ITD_CAPTCHA_SITE_KEY = "sk_44d64cf7bf8bc8377f5b";
+/** Назначение токена по умолчанию. Сервер сверяет его с операцией. */
+const DEFAULT_ACTION = "login";
+/** Размеры карточки, px. Их же виджет сообщает сайту через `postMessage`. */
+const WIDTH$1 = 300;
+const HEIGHT$1 = 74;
+/** Насколько правее левого края контейнера находится чекбокс, px. */
+const CHECKBOX_OFFSET_X$1 = 34;
+/**
+* Собирает страницу с одним виджетом собственной капчи ИТД.
+*
+* Виджет — iframe чужого происхождения (`captcha.итд.com`), и наружу он отдаёт токен
+* единственным способом: `postMessage` в родителя. Эта страница ровно так его и слушает —
+* как сам сайт.
+*
+* Слушатель кладёт результат в скрытые поля, а не в переменную `window`: стелс-драйверы вроде
+* `patchright` выполняют `page.evaluate` в изолированном мире, откуда переменные страницы
+* не видны, зато DOM общий.
+*
+* `action` задаёт назначение токена (`login`, `register`, `password_reset`) — сервер сверяет
+* его с операцией, поэтому он не выдумывается, а приходит из настроек обработчика.
+*/
+function buildItdCaptchaPage(input) {
+	const origin = embed(input.captchaOrigin);
+	const src = embed(`${input.captchaOrigin}/widget.html?sitekey=${encodeURIComponent(input.sitekey)}&theme=${encodeURIComponent(input.theme)}&action=${encodeURIComponent(input.action)}`);
+	return buildWidgetPage({
+		title: "Проверка",
+		width: WIDTH$1,
+		height: HEIGHT$1,
+		widgetStyle: `
+    border: 0;
+    display: block;`,
+		head: `<script>
+  window.addEventListener('message', function (event) {
+    if (event.origin !== ${origin}) return;
+    var data;
+    try {
+      data = typeof event.data === 'string' ? JSON.parse(event.data) : event.data;
+    } catch (e) {
+      return;
+    }
+    if (!data) return;
+    var token = document.getElementById('itd-token');
+    var error = document.getElementById('itd-error');
+    if (data.type === 'token' && data.token) token.value = data.token;
+    else if (data.type === 'expired') token.value = '';
+    else if (data.type === 'error') error.value = String(data.code || 'error');
+  });
+<\/script>`,
+		body: `<input type="hidden" id="itd-token">
+<input type="hidden" id="itd-error">
+<iframe id="widget" src=${src} title="Проверка"></iframe>`
+	});
+}
+/**
+* Читает результат виджета капчи ИТД.
+*
+* Токен приходит в родителя через `postMessage`, и слушатель страницы кладёт его в скрытое
+* поле. Читаем из DOM, а не из `window`: стелс-драйверы выполняют `evaluate` в изолированном
+* мире, где переменных страницы нет, а DOM общий.
+*/
+function readState$1(page) {
+	return page.evaluate(() => {
+		const token = document.querySelector("#itd-token");
+		const error = document.querySelector("#itd-error");
+		return {
+			token: token?.value || null,
+			error: error?.value || null
+		};
+	});
+}
+/**
+* Создаёт обработчик собственной капчи ИТД.
+*
+* @throws {TypeError} при некорректных настройках
+*/
+function itdCaptcha(options = {}) {
+	const sitekey = requireText(options.sitekey ?? "sk_44d64cf7bf8bc8377f5b", "sitekey");
+	const action = requireText(options.action ?? DEFAULT_ACTION, "action");
+	const captchaOrigin = resolveOrigin(options.captchaOrigin ?? "https://captcha.xn--d1ah4a.com", "captchaOrigin");
+	return {
+		type: CaptchaType.Itd,
+		label: "капчи ИТД",
+		buildPage: ({ theme }) => buildItdCaptchaPage({
+			sitekey,
+			theme,
+			action,
+			captchaOrigin
+		}),
+		widgetReadySelector: "#widget",
+		checkboxOffsetX: CHECKBOX_OFFSET_X$1,
+		readState: readState$1,
+		isPermanentWidgetError: () => false
+	};
+}
+//#endregion
+//#region src/providers/turnstile.ts
+/**
+* Публичный ключ виджета Cloudflare Turnstile на итд.com.
+*
+* Ключ публичный — виджет отдаёт его браузеру каждому посетителю — и привязан к домену
+* итд.com, поэтому больше ни для чего не годится. Держим его прямо в пакете: это его данные,
+* а не пользовательская настройка. Тот же ключ экспортирует `itd-api`.
+*/
+const TURNSTILE_SITE_KEY = "0x4AAAAAACHhxczw6fJGwPBg";
+/** Размеры контейнера виджета, px. Столько же он занимает на самом сайте. */
+const WIDTH = 300;
+const HEIGHT = 65;
+/** Насколько правее левого края контейнера находится чекбокс, px. */
+const CHECKBOX_OFFSET_X = 30;
+/** Коды Cloudflare вида `110***` означают, что ключ не разрешён для домена. */
+const DOMAIN_ERROR_PREFIX = "110";
+/**
+* Собирает страницу с одним виджетом Cloudflare Turnstile.
+*
+* Виджет создаётся так же, как это делает сам сайт, — скриптом с `?onload=` и явным
+* `turnstile.render` с одним лишь `sitekey`. Ни `action`, ни `cdata` сайт не передаёт,
+* поэтому их не передаёт и эта страница: лишний параметр попал бы в ответ `siteverify`
+* и мог бы разойтись с тем, что ожидает сервер.
+*/
+function buildTurnstilePage(sitekey, theme) {
+	const key = embed(sitekey);
+	const widgetTheme = embed(theme);
+	return buildWidgetPage({
+		title: "Turnstile",
+		width: WIDTH,
+		height: HEIGHT,
+		head: `<script>
+  window.__itdToken = null;
+  window.__itdError = null;
+  window.onTurnstileLoad = function () {
+    var reset = function () {
+      window.__itdToken = null;
+      if (widgetId !== undefined) window.turnstile.reset(widgetId);
+    };
+    var widgetId = window.turnstile.render('#widget', {
+      sitekey: ${key},
+      theme: ${widgetTheme},
+      callback: function (token) { window.__itdToken = token; },
+      'error-callback': function (code) { window.__itdError = String(code || 'unknown'); return true; },
+      'timeout-callback': reset,
+      'expired-callback': reset
+    });
+  };
+<\/script>
+<script src="https://challenges.cloudflare.com/turnstile/v0/api.js?onload=onTurnstileLoad" async defer><\/script>`,
+		body: "<div id=\"widget\"></div>"
+	});
+}
+/**
+* Читает результат виджета Turnstile.
+*
+* Источников два. Скрытое поле `cf-turnstile-response` виджет заполняет всегда, а вот
+* `callback` срабатывает не в каждом сценарии: пройдясь сам, виджет успевает убрать iframe,
+* и обработчика можно не дождаться. Поле при этом остаётся заполненным, и лежит оно
+* в нашей странице, а не внутри iframe чужого происхождения, поэтому доступно.
+*/
+function readState(page) {
+	return page.evaluate(() => {
+		const field = document.querySelector("input[name=\"cf-turnstile-response\"]");
+		const scope = window;
+		return {
+			token: scope.__itdToken || field?.value || null,
+			error: scope.__itdError ?? null
+		};
+	});
+}
+/**
+* Создаёт обработчик Cloudflare Turnstile.
+*
+* @throws {TypeError} при некорректных настройках
+*/
+function turnstile(options = {}) {
+	const sitekey = requireText(options.sitekey ?? "0x4AAAAAACHhxczw6fJGwPBg", "sitekey");
+	return {
+		type: CaptchaType.Cloudflare,
+		label: "Turnstile",
+		buildPage: ({ theme }) => buildTurnstilePage(sitekey, theme),
+		widgetReadySelector: "#widget > div",
+		checkboxOffsetX: CHECKBOX_OFFSET_X,
+		readState,
+		isPermanentWidgetError: (code) => code.startsWith(DOMAIN_ERROR_PREFIX)
+	};
+}
+//#endregion
+//#region src/providers/registry.ts
+/**
+* Встроенные обработчики по имени провайдера.
+*
+* Имена — те же, какими провайдера называет сервер итд.com, поэтому значение из
+* `itd.auth.captchaProvider()` подходит как есть. `turnstile` принимается синонимом
+* `cloudflare`.
+*/
+const BUILT_IN = Object.freeze({
+	[CaptchaType.Itd]: itdCaptcha,
+	[CaptchaType.Cloudflare]: turnstile,
+	turnstile
+});
+function isHandler(value) {
+	return typeof value === "object" && value !== null && typeof value.type === "string" && typeof value.buildPage === "function" && typeof value.readState === "function";
+}
+/**
+* Находит обработчик по имени провайдера либо принимает готовый.
+*
+* @throws {TypeError} если имя незнакомо или передано не то
+*/
+function resolveHandler(target) {
+	if (isHandler(target)) return target;
+	if (typeof target !== "string" || target.trim() === "") throw new TypeError(`Тип капчи должен быть именем провайдера или объектом CaptchaHandler, получено: ${typeof target}`);
+	const factory = BUILT_IN[target];
+	if (!factory) throw new TypeError(`Неизвестный тип капчи: ${target}. Известны ${Object.keys(BUILT_IN).join(", ")}. Свой провайдер передайте объектом CaptchaHandler.`);
+	return factory();
+}
+//#endregion
+//#region src/runner.ts
+/** Разброс координат клика, px в каждую сторону. */
+const CLICK_JITTER = 4;
+/** Пауза перед первым касанием, мс. */
+const HUMAN_DELAY = [1500, 2500];
+/** Как часто опрашивается состояние виджета, мс. */
+const POLL_INTERVAL = 250;
+/** Сколько ждать между повторными кликами, мс. */
+const CLICK_INTERVAL = 4e3;
+/** Сколько ждать появления виджета, мс. */
+const WIDGET_APPEAR_TIMEOUT = 15e3;
+/** Настройки контекста по умолчанию. Заменяются целиком через `contextOptions`. */
+const DEFAULT_CONTEXT_OPTIONS = {
+	locale: "ru-RU",
+	viewport: {
+		width: 1280,
+		height: 800
+	}
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const between = (min, max) => min + Math.random() * (max - min);
+/**
+* Версия браузера для текста ошибки.
+*
+* Сборка Chromium — первое, что стоит проверить при отказе виджета: часть сборок его
+* не проходит. Метода может не быть, если браузер передали свой.
+*/
+function browserVersion(browser) {
+	try {
+		return browser.version?.();
+	} catch {
+		return;
+	}
+}
+/**
+* Кликает по чекбоксу виджета.
+*
+* Чекбокс лежит в iframe чужого происхождения, до его DOM не дотянуться — клик идёт
+* по координатам. Отсчёт ведётся от собственного контейнера известного размера, поэтому
+* попадание не зависит от разметки виджета. Координаты слегка разбрасываются: один и тот же
+* пиксель раз за разом — заметная закономерность.
+*/
+async function clickCheckbox(page, offsetX) {
+	const box = await (await page.$("#widget"))?.boundingBox();
+	if (!box) return false;
+	const x = box.x + offsetX + between(-4, CLICK_JITTER);
+	const y = box.y + box.height / 2 + between(-4, CLICK_JITTER);
+	await page.mouse.move(x, y, { steps: 8 });
+	await page.mouse.click(x, y, { delay: between(40, 110) });
+	return true;
+}
+/** Ждёт токен, периодически подталкивая виджет кликом. */
+async function waitForToken(page, handler, options, browser) {
+	const deadline = Date.now() + options.timeout;
+	await page.waitForSelector(handler.widgetReadySelector, {
+		timeout: Math.min(WIDGET_APPEAR_TIMEOUT, options.timeout),
+		state: "attached"
+	}).catch(() => {});
+	let nextClickAt = Date.now() + between(HUMAN_DELAY[0], HUMAN_DELAY[1]);
+	let lastError;
+	while (Date.now() < deadline) {
+		const state = await handler.readState(page);
+		if (state.token) {
+			options.logger?.("токен получен");
+			return state.token;
+		}
+		if (state.error && state.error !== lastError) {
+			if (handler.isPermanentWidgetError(state.error)) throw new CaptchaError(CaptchaFailure.WidgetError, `Виджет ${handler.label} отказал для домена ${options.origin} (код ${state.error}): ключ не разрешён для этого домена.`, {
+				type: handler.type,
+				widgetCode: state.error
+			});
+			lastError = state.error;
+			options.logger?.(`виджет сообщил об ошибке ${state.error}, ждём повтора`);
+		}
+		if (Date.now() >= nextClickAt && await clickCheckbox(page, handler.checkboxOffsetX)) {
+			options.logger?.("клик по чекбоксу");
+			nextClickAt = Date.now() + CLICK_INTERVAL;
+		}
+		await sleep(POLL_INTERVAL);
+	}
+	const version = browserVersion(browser);
+	throw new CaptchaError(CaptchaFailure.Timeout, `Виджет ${handler.label} не отдал токен за ${options.timeout} мс` + (lastError ? `; последняя ошибка виджета — ${lastError}` : "") + (version ? `; браузер — ${version}` : "") + ". Рабочие связки драйвера и браузера перечислены в README пакета.", lastError ? {
+		type: handler.type,
+		widgetCode: lastError
+	} : { type: handler.type });
+}
+async function solveOnce(browser, handler, options) {
+	const context = await browser.newContext(options.contextOptions ?? DEFAULT_CONTEXT_OPTIONS);
+	try {
+		const page = await context.newPage();
+		const url = `${options.origin}/`;
+		const body = handler.buildPage({ theme: options.theme });
+		await page.route(url, (route) => route.fulfill({
+			status: 200,
+			contentType: "text/html; charset=utf-8",
+			body
+		}));
+		await page.goto(url, { waitUntil: "domcontentloaded" });
+		return await waitForToken(page, handler, options, browser);
+	} finally {
+		await context.close().catch(() => {});
+	}
+}
+/** Ошибки настройки: повтор их не исправит. */
+function isPermanent(error) {
+	if (!(error instanceof CaptchaError)) return false;
+	if (error.reason === CaptchaFailure.DriverMissing) return true;
+	if (error.reason === CaptchaFailure.LaunchFailed) return true;
+	if (error.reason === CaptchaFailure.BrowserClosed) return true;
+	return error.reason === CaptchaFailure.WidgetError;
+}
+/**
+* Как драйверы сообщают, что страницы, контекста или браузера больше нет.
+*
+* Своего типа ошибки у них нет, поэтому остаётся текст сообщения.
+*/
+const CLOSED_MARKERS = [
+	"has been closed",
+	"target closed",
+	"browser has been closed",
+	"browser has disconnected",
+	"session closed"
+];
+function isClosedError(error) {
+	const message = error instanceof Error ? error.message.toLowerCase() : "";
+	return CLOSED_MARKERS.some((marker) => message.includes(marker));
+}
+/** Приводит закрытие браузера к {@link CaptchaError}; остальное отдаёт как есть. */
+function toCaptchaError(error, handler) {
+	if (!isClosedError(error)) return error;
+	return new CaptchaError(CaptchaFailure.BrowserClosed, `Браузер закрылся до того, как виджет ${handler.label} отдал токен.`, { type: handler.type });
+}
+/**
+* Общий путь получения токена: поднимает браузер, решает виджет, закрывает браузер.
+*
+* Всё, что зависит от провайдера, приходит в {@link CaptchaHandler}; здесь остаётся только
+* то, что одинаково для любого виджета.
+*
+* @throws {CaptchaError} если токен получить не удалось
+*/
+async function runSolver(handler, options) {
+	const browser = options.browser ?? await launchBrowser(options);
+	const owned = options.browser === void 0;
+	try {
+		for (let attempt = 1; attempt <= options.attempts; attempt++) try {
+			options.logger?.(`попытка ${attempt} из ${options.attempts}`);
+			return await solveOnce(browser, handler, options);
+		} catch (raw) {
+			const error = toCaptchaError(raw, handler);
+			if (isPermanent(error) || attempt === options.attempts) throw error;
+			options.logger?.(`попытка ${attempt} не удалась: ${error instanceof Error ? error.message : String(error)}`);
+		}
+		throw new CaptchaError(CaptchaFailure.Timeout, `Токен ${handler.label} получить не удалось`, { type: handler.type });
+	} finally {
+		if (owned) await browser.close().catch(() => {});
+	}
+}
+//#endregion
+//#region src/solve.ts
+/**
+* Получает один токен капчи указанного типа.
+*
+* Поднимает браузер, решает виджет и закрывает браузер за собой.
+*
+* @example
+* ```ts
+* await solveCaptcha(CaptchaType.Itd);
+* await solveCaptcha(itdCaptcha({ action: 'register' }), { headless: true });
+* await solveCaptcha(myOwnHandler);
+* ```
+*
+* @throws {CaptchaError} если токен получить не удалось
+* @throws {TypeError} при некорректных настройках или незнакомом типе
+*/
+async function solveCaptcha(target, options = {}) {
+	return runSolver(resolveHandler(target), resolveOptions(options));
+}
+/**
+* Собирает источник токена для клиента `itd-api`.
+*
+* Токен одноразовый и живёт несколько минут, поэтому клиент спрашивает его заново перед
+* каждым входом. Браузер поднимается на время одного вызова и сразу закрывается.
+*
+* @example
+* ```ts
+* import { ItdClient } from 'itd-api';
+* import { FileTokenStorage } from 'itd-api/node';
+* import { createCaptchaSolver } from '@itd-api/captcha';
+*
+* const itd = new ItdClient({
+*   storage: new FileTokenStorage('./.itd-session.json'),
+*   auth: {
+*     email: process.env.ITD_EMAIL!,
+*     password: process.env.ITD_PASSWORD!,
+*     captcha: createCaptchaSolver(),
+*   },
+* });
+* ```
+*/
+function createCaptchaSolver(options = {}) {
+	return { getToken: (type) => solveCaptcha(type, options) };
+}
+//#endregion
+export { CaptchaError, CaptchaFailure, CaptchaType, DEFAULT_CAPTCHA_ORIGIN, DEFAULT_ORIGIN, ITD_CAPTCHA_SITE_KEY, TURNSTILE_SITE_KEY, createCaptchaSolver, itdCaptcha, launchBrowser, solveCaptcha, turnstile };
+
+//# sourceMappingURL=index.js.map