@operstack/audit 0.19.2 → 0.19.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operstack/audit",
-  "version": "0.19.2",
+  "version": "0.19.3",
   "description": "SEO, AEO and GEO audit generator: collect public signals from a site into audit.json, let an analyst or an agent fill the narrative, render the OperStack report as HTML and PDF.",
   "type": "module",
   "license": "MIT",

package/src/test-blocked.mjs

@@ -80,5 +80,21 @@ const CLOSED = 'User-agent: GPTBot\nDisallow: /\n\nUser-agent: ClaudeBot\nDisall
   ok('в английском нет кириллицы', !/[А-Яа-яЁё]/.test(blockedNote({ status: 403, challenged: true, robotsText: OPEN, lang: 'en' }).text));
 }
 
+// ---- несуществующий адрес: человек чаще всего просто опечатался
+//
+// Стояло «Сайт ответил ничем на https://…»: и коряво, и бесполезно. Человек, который ошибся в
+// букве, должен узнать об этом первым делом, а не гадать, что с его сайтом.
+{
+  const { checkVisibility } = await import('./visibility.mjs');
+  for (const lang of ['ru', 'en']) {
+    const v = await checkVisibility('https://takogo-domena-tochno-net-4f7a2b9c.ru/', { budgetMs: 8500, samplePages: 3, lang });
+    ok(`${lang}: балла у несуществующего адреса нет`, v.ok === false);
+    ok(`${lang}: названа вероятная причина, опечатка`, lang === 'ru' ? /опечатка в адресе/.test(v.error) : /typo in the address/.test(v.error));
+    ok(`${lang}: сказано, что делать`, lang === 'ru' ? /проверьте написание/.test(v.error) : /check the spelling/.test(v.error));
+    ok(`${lang}: нет старого «ответил ничем»`, lang === 'ru' ? !/ответил ничем/.test(v.error) : !/answered nothing/.test(v.error));
+    ok(`${lang}: чужого языка нет`, lang === 'ru' ? !/[A-Za-z]{5}/.test(v.error.replace(/https?:\/\/[^\s]+/g, '')) : !/[А-Яа-яЁё]/.test(v.error));
+  }
+}
+
 if (bad) { console.error(`\n${bad} тест(ов) упало`); process.exit(1); }
 console.log('\nпро чужой сайт говорим только измеренное');

package/src/visibility.mjs

@@ -48,7 +48,9 @@ export const MESSAGES = {
   en: {
     badInput: 'Enter a public site address, for example example.com',
     tooSlow: 'The site took too long to answer',
-    badAnswer: (status, url) => `The site answered ${status || 'nothing'} for ${url}`,
+    badAnswer: (status, url) => `The site answered ${status} for ${url}`,
+    // Чаще всего это опечатка в адресе, и сказать об этом надо первым делом, а не после разбора.
+    unreachable: (url) => `Nothing answered at ${url}. Most often that is a typo in the address: check the spelling, and if the site really is there, it may be down right now.`,
     botWall: (status) => `The site refuses unknown clients (HTTP ${status}), so this check could not read a single page.`,
     botChallenge: (status) => `The site sits behind a browser challenge (Cloudflare, HTTP ${status}), so this check could not read a single page.`,
     // Что мы знаем про роботов ИИ, когда нас самих развернули: ровно то, что написано в правилах
@@ -98,7 +100,8 @@ export const MESSAGES = {
   ru: {
     badInput: 'Введите адрес публичного сайта, например example.ru',
     tooSlow: 'Сайт слишком долго не отвечал',
-    badAnswer: (status, url) => `Сайт ответил ${status ? `кодом ${status}` : 'ничем'} на ${url}`,
+    badAnswer: (status, url) => `Сайт ответил кодом ${status} на ${url}`,
+    unreachable: (url) => `По адресу ${url} никто не ответил. Чаще всего это опечатка в адресе: проверьте написание. Если сайт там действительно есть, значит он сейчас недоступен.`,
     botWall: (status) => `Сайт отказывает незнакомым клиентам (код ${status}), поэтому прочитать хотя бы одну страницу проверка не смогла.`,
     botChallenge: (status) => `Сайт закрыт проверкой браузера (Cloudflare, код ${status}), поэтому прочитать хотя бы одну страницу проверка не смогла.`,
     rulesAllowBots: (list) => ` Правила самого сайта роботов ИИ при этом пускают (${list}), а защита такого типа проверенных роботов нередко пропускает. Пустят ли их на деле, решает защита, а не эта проверка, поэтому в плюс или в минус сайту это не зачтено.`,
@@ -403,8 +406,9 @@ export async function checkVisibility(input, { budgetMs = 8500, lang = 'en', sam
      */
     const note = blockedNote({ status: home.status, challenged, blocked, robotsText: robotsRes.ok ? robotsRes.text : null, lang });
     const error = home.error === 'timeout' ? T.tooSlow
-      : blocked ? note.text
-        : T.badAnswer(home.status, url);
+      : home.error === 'unreachable' || !home.status ? T.unreachable(url)
+        : blocked ? note.text
+          : T.badAnswer(home.status, url);
     // `botsBlocked` говорит только про написанные правила, а не про поведение защиты: по нему
     // нельзя утверждать, что робота не пустили, можно лишь, что ему не разрешали.
     return { ok: false, blocked, challenged, status: home.status, error, botsBlocked: note.botsBlocked };