layero 0.11.11 → 0.11.13

package/dist/api.js

@@ -4,6 +4,16 @@ import { looksLikeId } from "./project-ref.js";
 // Один опрос логов отвечает за доли секунды. 30 с — заведомо «запрос завис»,
 // а не «сборка идёт долго»: длительность сборки на ответ этой ручки не влияет.
 export const POLL_TIMEOUT_MS = 30_000;
+/** Устройство и страница замера — одинаковые у запуска и у результата. */
+function perfQuery(opts) {
+    const q = new URLSearchParams();
+    if (opts.device)
+        q.set("device", opts.device);
+    if (opts.path)
+        q.set("path", opts.path);
+    const s = q.toString();
+    return s ? `?${s}` : "";
+}
 export class ApiError extends Error {
     status;
     body;
@@ -292,12 +302,12 @@ export class ApiClient {
     }
     // --- Замеры (AGENT-11) ----------------------------------------------
     /** Запустить замер активного деплоя. Не ждёт: прогон асинхронный. */
-    startPerfCheck(projectId) {
-        return this.request("POST", `/projects/${projectId}/perf-check`);
+    startPerfCheck(projectId, opts = {}) {
+        return this.request("POST", `/projects/${projectId}/perf-check${perfQuery(opts)}`);
     }
     /** Результат последнего замера со сравнением с предыдущим деплоем. */
-    getPerfCheck(projectId) {
-        return this.request("GET", `/projects/${projectId}/perf-check`);
+    getPerfCheck(projectId, opts = {}) {
+        return this.request("GET", `/projects/${projectId}/perf-check${perfQuery(opts)}`);
     }
     // --- Домены (AGENT-09) ---------------------------------------------
     listDomains(projectId) {

package/dist/bin/layero.js

@@ -2,6 +2,7 @@
 import { Command } from "commander";
 import chalk from "chalk";
 import { whoamiCmd } from "../commands/whoami.js";
+import { nextActionFor } from "../next-action.js";
 import { logoutCmd } from "../commands/logout.js";
 import { projectsCreateCmd, projectsDeleteCmd, projectsListCmd } from "../commands/projects.js";
 import { sourcesConnectCmd, sourcesListCmd, sourcesReposCmd } from "../commands/sources.js";
@@ -352,14 +353,18 @@ async function main() {
         .description("Measure site performance and compare it with the previous deploy.");
     perf
         .command("check")
-        .description("Start a measurement of the active deploy. The run is asynchronous — with --wait the command waits for the result.")
+        .description("Measure the main branch (Lighthouse score, verdict as in the dashboard). The run is asynchronous — with --wait the command waits for the result.")
         .option("--project <id_or_slug>", "project (default: the linked project)")
         .option("--wait", "wait for the result (up to 4 minutes)")
+        .option("--device <desktop|mobile>", "device profile (default: desktop)")
+        .option("--path <path>", "page on the main branch, e.g. /pricing (default: /)")
         .action(async (opts) => perfCheckCmd({ ...opts, json: program.opts().json }));
     perf
         .command("show")
         .description("Show the latest measurement and the comparison with the previous deploy.")
         .option("--project <id_or_slug>", "project (default: the linked project)")
+        .option("--device <desktop|mobile>", "device profile (default: desktop)")
+        .option("--path <path>", "page on the main branch, e.g. /pricing (default: /)")
         .action(async (opts) => perfShowCmd({ ...opts, json: program.opts().json }));
     const domains = program
         .command("domains")
@@ -527,7 +532,11 @@ function asAccountStateError(err) {
             : "";
         return new LayeroError("plan_limit", what
             ? `Тариф не позволяет больше ${what}${counts}.`
-            : "Действие недоступно на текущем тарифе.", "смените тариф на app.layero.ru/billing или освободите место, удалив ненужное");
+            // Сервер прислал готовую причину («Замер скорости доступен на тарифе
+            // Pro.») — она точнее общего текста.
+            : typeof detail.message === "string" && detail.message
+                ? detail.message
+                : "Действие недоступно на текущем тарифе.", "смените тариф на app.layero.ru/billing или освободите место, удалив ненужное");
     }
     // 🚨 Понятный отказ сервера не имеет права превращаться в нашу поломку.
     // 409 с `reason: reserved` и текстом «имя зарезервировано платформой»
@@ -544,7 +553,8 @@ function asAccountStateError(err) {
             // Общий совет — последний: причина и лекарство чаще всего уже в тексте
             // отказа (подсказки SQL про роли и Авторизацию, T-20261025-9), и
             // «исправьте запрос» уводил агента от них.
-            detail.next_action ?? "причина и что сделать — в тексте отказа; исправьте и повторите");
+            detail.next_action ?? detail.hint ?? nextActionFor(err.status, detail.message) ??
+                "прочитайте message: в нём причина отказа сервера; поправьте команду и повторите");
         }
     }
     return null;
@@ -573,6 +583,8 @@ function detailOf(body) {
                 code: typeof detail.code === "string" ? detail.code : undefined,
                 message,
                 next_action: typeof detail.next_action === "string" ? detail.next_action : undefined,
+                // Шлюз данных кладёт подсказку в `hint` (формат PostgREST).
+                hint: typeof detail.hint === "string" && detail.hint ? detail.hint : undefined,
             };
         }
     }

package/dist/commands/data-api.js

@@ -495,6 +495,11 @@ export async function dataEnableCmd(opts) {
             public_key: publicKey,
             secret_key: secretKey,
             reapplied,
+            ...(publicKey || secretKey
+                ? { next_action: "ключи показаны один раз — сохраните их сейчас. Публичный потом: layero data env " +
+                        `(у подключённого проекта) или новый: layero data keys issue --db ${shellArg(ref)}; ` +
+                        "секретный больше не покажут — только выпуск нового" }
+                : {}),
         });
         return;
     }

package/dist/commands/db.js

@@ -122,23 +122,23 @@ export async function dbListCmd(opts) {
  * не надоест»: выделенный кластер поднимается 7–13 минут, и повесить терминал
  * на всё это время нельзя. Не дождались — говорим об этом прямо.
  */
-async function waitUntilReady(api, org, name, timeoutMs = 90_000) {
+export async function waitUntilReady(api, org, name, timeoutMs = 90_000, pollMs = 2000) {
     const until = Date.now() + timeoutMs;
     while (Date.now() < until) {
-        await new Promise((r) => setTimeout(r, 2000));
         try {
             const all = await api.listDatabases(org);
             const mine = all.find((d) => d.name === name);
             if (mine && mine.status === "active")
-                return true;
+                return "active";
             if (mine && mine.status === "failed")
-                return false;
+                return "failed";
         }
         catch {
             // Сеть моргнула — это не повод объявлять базу несозданной.
         }
+        await new Promise((r) => setTimeout(r, pollMs));
     }
-    return false;
+    return "creating";
 }
 export async function dbCreateCmd(name, opts) {
     const mode = detectMode();
@@ -181,25 +181,40 @@ export async function dbCreateCmd(name, opts) {
         }
         throw err;
     });
+    // 🚨 ЖДЁМ ГОТОВНОСТИ И В JSON (T-20261025-33, п. 1). Раньше событие уходило
+    // сразу, пока база `creating`, и следующая команда агента (`data enable`,
+    // `db sql`) получала 404 «база не найдена или не активна» — агент искал
+    // ошибку в имени. Теперь событие несёт `status`, а `creating` после 90 с —
+    // с подсказкой, что делать.
+    const json = mode.json || opts.json;
+    if (!json)
+        process.stdout.write(`${chalk.dim("…")} готовим базу «${name}» в организации ${org}`);
+    const state = await waitUntilReady(api, org, name);
+    if (!json)
+        process.stdout.write("\r\u001b[2K");
     // Пароль отдаётся ОДИН РАЗ — второй раз его не покажет никто, только
     // ротация. Поэтому он и в JSON-режиме, и в терминале.
-    if (mode.json || opts.json) {
+    if (json) {
         // 🚨 Пароль — в ОДНОМ поле (T-20261025-12). Раньше он шёл ещё и отдельным
         // `password`: агент маскировал строку подключения и не замечал второе
         // поле, и пароль уезжал в вывод инструмента. `secrets` называет, что
         // маскировать.
         emit({ event: "database_created", org, name, connection_string: created.connection_string,
-            secrets: ["connection_string"] });
+            secrets: ["connection_string"], status: state,
+            ...(state === "creating"
+                ? { next_action: `база ещё готовится — дождитесь status active в layero db list --org ${org} ` +
+                        "(обычно до 2 минут), затем data enable / db sql" }
+                : state === "failed"
+                    ? { next_action: "подготовка базы не удалась — удалите её в панели и создайте заново; " +
+                            "повторится — напишите в поддержку" }
+                    : {}) });
         return;
     }
     // 🚨 БАЗА ЕЩЁ НЕ ГОТОВА В ЭТОТ МОМЕНТ. Ручка стала асинхронной: она пишет
     // намерение и возвращается, подготовка идёт минуты. Печатать «заведена» и
     // строку подключения сразу значит отправить человека к `psql`, который
     // ответит «database does not exist», — и он пойдёт искать причину в пароле.
-    process.stdout.write(`${chalk.dim("…")} готовим базу «${name}» в организации ${org}`);
-    const ready = await waitUntilReady(api, org, name);
-    process.stdout.write("\r\u001b[2K");
-    if (ready) {
+    if (state === "active") {
         console.log(`${chalk.green("✓")} база «${name}» готова в организации ${org}`);
     }
     else {

package/dist/commands/perf.js

@@ -18,7 +18,7 @@ function render(d) {
     if (d.score !== null && d.score !== undefined) {
         const t = d.timings ?? {};
         const bits = [
-            `балл ${d.score}`,
+            `балл Lighthouse ${d.score}`,
             t.lcp_ms ? `LCP ${t.lcp_ms} мс` : null,
             t.ttfb_ms ? `TTFB ${t.ttfb_ms} мс` : null,
         ].filter(Boolean);
@@ -32,12 +32,12 @@ export async function perfCheckCmd(opts) {
     const id = await projectId(api, opts);
     let started;
     try {
-        started = await api.startPerfCheck(id);
+        started = await api.startPerfCheck(id, opts);
     }
     catch (err) {
         if (err instanceof ApiError && err.status === 429) {
             // Замер уже идёт — это не ошибка, а ответ на вопрос «когда будет».
-            const current = await api.getPerfCheck(id).catch(() => null);
+            const current = await api.getPerfCheck(id, opts).catch(() => null);
             if (current) {
                 if (mode.json) {
                     emit({ event: "perf_check", ...current });
@@ -67,7 +67,7 @@ export async function perfCheckCmd(opts) {
     let last = started;
     while (Date.now() < deadline) {
         await new Promise((r) => setTimeout(r, 8000));
-        last = await api.getPerfCheck(id);
+        last = await api.getPerfCheck(id, opts);
         if (last.verdict !== "pending")
             break;
     }
@@ -83,7 +83,7 @@ export async function perfShowCmd(opts) {
     const id = await projectId(api, opts);
     let out;
     try {
-        out = await api.getPerfCheck(id);
+        out = await api.getPerfCheck(id, opts);
     }
     catch (err) {
         if (err instanceof ApiError && err.status === 404) {

package/dist/next-action.js

@@ -0,0 +1,35 @@
+/**
+ * Что делать дальше — по известным отказам сервера (T-20261025-33, п. 2).
+ *
+ * Сервер отдаёт эти отказы строкой без подсказки, а агент читает именно
+ * `next_action`: общий совет «исправьте и повторите» уводил его искать
+ * опечатку там, где база ещё создаётся. Таблица — по тексту отказа, потому
+ * что кода у этих отказов нет; новый текст на сервере без строки здесь
+ * получит общий совет, а не неверный.
+ */
+export function nextActionFor(status, message) {
+    const m = message.toLowerCase();
+    const rules = [
+        [/не найдена или не активна/,
+            "если базу только что создали — она ещё готовится: дождитесь status active в layero db list " +
+                "и повторите; иначе проверьте имя базы там же"],
+        [/у организации уже есть/,
+            "общая база одна на организацию: используйте её (layero db list) или заведите выделенный " +
+                "инстанс в панели"],
+        [/relation .* does not exist|таблиц[аы] .* не найден/,
+            "таблицы нет: проверьте имя и схему — SELECT schemaname, tablename FROM pg_tables " +
+                "WHERE schemaname NOT IN ('pg_catalog', 'information_schema')"],
+        [/schema .* does not exist/,
+            "схемы нет: создайте её (CREATE SCHEMA …) или уберите имя схемы из запроса"],
+        [/permission denied/,
+            "у роли запроса нет прав: выполните его владельцем базы (layero db sql) или выдайте GRANT"],
+        [/syntax error/,
+            "синтаксическая ошибка в SQL — поправьте запрос по месту, указанному в сообщении"],
+        [/(лимит|тариф)/,
+            "смените тариф на app.layero.ru/billing или освободите место, удалив ненужное"],
+    ];
+    for (const [re, action] of rules)
+        if (re.test(m))
+            return action;
+    return status === 404 ? "проверьте имя или идентификатор: layero db list / layero list покажут, что есть" : undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "layero",
-  "version": "0.11.11",
+  "version": "0.11.13",
   "description": "Layero CLI — deploy a directory or a repo to hosting with build servers in Russia. JSON events and exit codes for AI agents and CI.",
   "license": "MIT",
   "type": "module",