fullstack-gates 0.1.0

package/scripts/preflight.ts

@@ -0,0 +1,171 @@
+/**
+ * Preflight for a verification tier.
+ *
+ * The rule: **a tier whose prerequisites are missing FAILS — it does not skip.** Today the
+ * integration suite silently skips without `TEST_DATABASE_URL`, so a CI run with no Postgres is
+ * green and proves nothing. That is the same lie as a hand-ticked checkbox, and it is worse in CI,
+ * because nobody is looking.
+ *
+ * So: each tier declares what it needs, this checks it, and when something is missing it says what
+ * to run — instead of a green tick over an empty suite.
+ *
+ *   bun run scripts/preflight.ts it     # tier 3: real Postgres
+ *   bun run scripts/preflight.ts e2e    # tier 4: Postgres + a live app + a browser
+ */
+const tier = Bun.argv[2] ?? "unit";
+
+type Check = { what: string; ok: boolean | Promise<boolean>; fix: string };
+
+const DB = process.env.TEST_DATABASE_URL ?? "";
+const BASE = (process.env.E2E_BASE_URL || "http://localhost:3000").replace(/\/+$/, "");
+/** Креды уровня e2e — те же, что читает `apps/web/e2e/support.ts`. Один источник, иначе разойдутся. */
+const E2E_EMAIL = process.env.E2E_EMAIL || process.env.SEED_ADMIN_EMAIL || "admin@example.com";
+const E2E_PASSWORD = process.env.E2E_PASSWORD || process.env.SEED_ADMIN_PASSWORD || "";
+/** Пакетов в прогоне ~6, у каждого свой пул; плюс запас на psql/dev. */
+const MIN_FREE_SLOTS = 30;
+
+async function pgReachable(url: string): Promise<boolean> {
+  if (!url) return false;
+  try {
+    // Bun's own Postgres client — no dependency to resolve from the repo root (the `pg` import did
+    // not resolve here and made a perfectly healthy database look down: a preflight that lies is
+    // worse than none).
+    const sql = new Bun.SQL(url);
+    await sql`select 1`;
+    await sql.end();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Enough free connection slots to run the suite.
+ *
+ * This looks pedantic and is not: a `bun run dev` left running holds a pool against the SAME
+ * Postgres, and the suite then dies with "remaining connection slots are reserved for superuser" —
+ * which surfaces as DrizzleQueryError deep inside unrelated tests. It reads as a code regression, and
+ * you will go bisecting commits for an hour before you look at `pg_stat_activity`. Ask the question
+ * here, once, and say what to close.
+ */
+async function enoughConnectionSlots(url: string): Promise<boolean> {
+  if (!url) return false;
+  try {
+    const sql = new Bun.SQL(url);
+    const [row] = await sql`
+      select
+        (select setting::int from pg_settings where name = 'max_connections') as max,
+        (select count(*)::int from pg_stat_activity) as used
+    `;
+    await sql.end();
+    const free = (row?.max ?? 0) - (row?.used ?? 0);
+    if (free < MIN_FREE_SLOTS) {
+      console.error(
+        `\n   ℹ свободных слотов Postgres: ${free} (из ${row?.max}). Тесты открывают пул на пакет.`
+      );
+    }
+    return free >= MIN_FREE_SLOTS;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Есть ли пользователь, которым сценарий собирается войти.
+ *
+ * Без него e2e падает на форме входа с сообщением про неверные креды — то есть выглядит как поломка
+ * авторизации, хотя это просто незасеянная база. Спросить один раз здесь дешевле, чем разбираться потом.
+ */
+async function userSeeded(databaseUrl: string, email: string): Promise<boolean> {
+  if (!databaseUrl || !email) return false;
+  try {
+    const sql = new Bun.SQL(databaseUrl);
+    const rows = await sql`select count(*)::int as n from users where email = ${email}`;
+    await sql.end();
+    return (rows[0]?.n ?? 0) > 0;
+  } catch {
+    return false;
+  }
+}
+
+async function httpOk(url: string): Promise<boolean> {
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(3000) });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+
+const CHECKS: Record<string, Check[]> = {
+  unit: [],
+
+  it: [
+    {
+      what: "TEST_DATABASE_URL задан",
+      ok: DB.length > 0,
+      fix: "export TEST_DATABASE_URL=postgres://app:app@localhost:5432/app_test",
+    },
+    {
+      what: "Postgres отвечает",
+      // ТОЛЬКО доступность. Мигрирована ли база — не спрашиваем: `test:it` прогоняет `db:migrate`
+      // перед сюитой, и авторитет по состоянию схемы там, где он и должен быть, — у drizzle.
+      // Прежняя подпись здесь обещала «И база мигрирована», а проверяла «в public есть хоть одна
+      // таблица». Отставшая база проходила гейт, и падение слайса выглядело как регрессия кода.
+      ok: pgReachable(DB),
+      fix: "createdb app_test   (или подними Postgres)",
+    },
+    {
+      what: `свободно ≥${MIN_FREE_SLOTS} слотов подключений Postgres`,
+      ok: enoughConnectionSlots(DB),
+      fix:
+        "закрой то, что держит пул (чаще всего — забытый `bun run dev`):\n" +
+        "       pkill -f 'bun --hot src/server.ts'\n" +
+        "     иначе прогон умрёт с «remaining connection slots are reserved for superuser» ВНУТРИ\n" +
+        "     посторонних тестов, и это будет выглядеть как регрессия в коде — а это лимит ресурса",
+    },
+  ],
+
+  e2e: [
+    {
+      what: `приложение живо на ${BASE}`,
+      // Именно `/api/health`, а НЕ произвольный путь: SPA-фолбэк отдаёт 200 на что угодно, поэтому
+      // проверка любого другого адреса проходила бы всегда — и была бы преформой, а не проверкой.
+      ok: httpOk(`${BASE}/api/health`),
+      fix: `bun run dev   (или E2E_BASE_URL=<адрес> bun run verify:all)`,
+    },
+    {
+      what: "пароль для входа задан (E2E_PASSWORD или SEED_ADMIN_PASSWORD)",
+      ok: E2E_PASSWORD.length > 0,
+      fix:
+        "задай SEED_ADMIN_PASSWORD в .env и засей пользователя: bun run db:seed\n" +
+        "     пароля по умолчанию здесь нет намеренно — известный пароль администратора хуже, чем его отсутствие",
+    },
+    {
+      what: "засеянный пользователь есть в базе",
+      ok: userSeeded(process.env.DATABASE_URL ?? "", E2E_EMAIL),
+      fix: "bun run db:seed   (без пользователя войти нечем, и сценарий упадёт на форме входа)",
+    },
+  ],
+};
+
+const checks = CHECKS[tier];
+if (!checks) {
+  console.error(`неизвестный уровень: ${tier} (unit | it | e2e)`);
+  process.exit(2);
+}
+
+const results = await Promise.all(checks.map(async (c) => ({ ...c, ok: await c.ok })));
+const failed = results.filter((r) => !r.ok);
+
+for (const r of results) console.log(`  ${r.ok ? "✅" : "❌"} ${r.what}`);
+
+if (failed.length > 0) {
+  console.error(`\n❌ уровень «${tier}» не может быть запущен — не выполнены условия:\n`);
+  for (const f of failed) console.error(`   ${f.what}\n     → ${f.fix}\n`);
+  console.error(
+    "Это НЕ повод пропустить уровень: пропущенный уровень выглядит как пройденный, и именно так\n" +
+      "в CI появляется зелёный прогон, который ничего не доказал.\n"
+  );
+  process.exit(1);
+}