layero 0.11.12 → 0.11.13

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";
@@ -552,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;
@@ -581,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/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.12",
+  "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",