layero 0.9.3 → 0.9.5

package/README.md

@@ -14,7 +14,7 @@ npx layero@latest deploy --json   # ships current dir, streams JSON events to st
 
 `layero deploy` prints `{"event":"ready","url":"https://..."}` on success. Show the URL to the user. That's the whole job.
 
-**If the user has no code yet** and wants a landing page built from scratch, this CLI is the wrong tool. Layero runs a remote MCP server for that — `https://mcp.layero.ru/mcp` (Streamable HTTP), registered as `ru.layero/layero` in the official MCP registry. It builds the page from a two-or-three-question brief and deploys it. Install it with `claude plugin marketplace add LayeroInfra/layero-claude && claude plugin install layero@layero-claude`, `codex mcp add layero --url https://mcp.layero.ru/mcp --bearer-token-env-var LAYERO_TOKEN`, or one click in Cursor from [land.layero.app](https://land.layero.app). Details: [docs.layero.ru/en/plugin/intro](https://docs.layero.ru/en/plugin/intro).
+**If the user has no code yet** and wants a landing page built from scratch, this CLI is the wrong tool. Layero runs a remote MCP server for that — `https://mcp.layero.ru/mcp` (Streamable HTTP), registered as `ru.layero/layero` in the official MCP registry. It builds the page from a two-or-three-question brief and deploys it. Install it with `claude plugin marketplace add LayeroInfra/layero-agents && claude plugin install layero@layero-claude`, `codex mcp add layero --url https://mcp.layero.ru/mcp --bearer-token-env-var LAYERO_TOKEN`, or one click in Cursor from [land.layero.app](https://land.layero.app). Details: [docs.layero.ru/en/plugin/intro](https://docs.layero.ru/en/plugin/intro).
 
 ## Install
 

package/dist/api.js

@@ -153,6 +153,7 @@ export class ApiClient {
             name: input.name,
             quota_gb: input.quota_gb ?? null,
             extensions: input.extensions ?? [],
+            preset: input.preset ?? true,
         });
     }
     connectDatabaseToProject(org, dbId, projectId) {
@@ -160,6 +161,11 @@ export class ApiClient {
             project_id: projectId,
         });
     }
+    /** Отвязать проект от базы. Роль проекта при этом удаляется, а переменная
+     *  уходит из его окружения — не сразу, а следующим деплоем. */
+    disconnectDatabaseFromProject(org, dbId, projectId) {
+        return this.request("DELETE", `/organizations/${org}/databases/${dbId}/projects/${projectId}`);
+    }
     queryDatabase(org, dbId, sql) {
         return this.request("POST", `/organizations/${org}/databases/${dbId}/query`, {
             sql,

package/dist/bin/layero.js

@@ -16,7 +16,7 @@ import { initCmd } from "../commands/init.js";
 import { diagnoseCmd, logsCmd } from "../commands/diagnose.js";
 import { perfCheckCmd, perfShowCmd } from "../commands/perf.js";
 import { dataEnvCmd } from "../commands/data.js";
-import { dbConnectCmd, dbCreateCmd, dbListCmd, dbSqlCmd } from "../commands/db.js";
+import { dbConnectCmd, dbCreateCmd, dbDisconnectCmd, dbListCmd, dbSqlCmd, } from "../commands/db.js";
 import { envListCmd, envSetCmd, envUnsetCmd } from "../commands/env.js";
 import { analyticsConnectCmd, analyticsDisconnectCmd, analyticsStatsCmd, analyticsStatusCmd, } from "../commands/analytics.js";
 import { domainsAddCmd, domainsListCmd, domainsPrimaryCmd, domainsRemoveCmd, domainsVerifyCmd, } from "../commands/domains.js";
@@ -225,15 +225,47 @@ async function main() {
     withOrg(db
         .command("create <name>")
         .description("Завести базу. Строка подключения печатается ОДИН раз.")
-        .option("--gb <number>", "объём платной базы в гигабайтах", (v) => parseInt(v, 10))).action(async (name, opts) => dbCreateCmd(name, { ...opts, json: program.opts().json }));
+        // 🚨 ФЛАГ ОСТАВЛЕН РАДИ ЧЕСТНОГО ОТКАЗА, А НЕ РАДИ РАБОТЫ. Он обещал
+        // «объём платной базы в гигабайтах» и не делал НИЧЕГО: сервер поле не
+        // читает ни одним путём создания — у Shared объём задаёт тариф, у
+        // выделенного диск ступени. Убрать его совсем значило бы отвечать
+        // «неизвестный параметр» тому, кто им пользовался, и оставить человека
+        // гадать, куда делся объём. Теперь команда говорит это словами (C9).
+        .option("--gb <number>", "БОЛЬШЕ НЕ РАБОТАЕТ: объём задаёт тариф или ступень", (v) => parseInt(v, 10))
+        // 🚨 ТЕ ЖЕ ФЛАГИ РАДИ ЧЕСТНОГО ОТКАЗА. Выделенный инстанс из терминала
+        // не заказать, и это осознанно: у заказа есть цена и заморозка денег, а
+        // карту в терминале не привяжешь и сумму подтвердить негде. Но человек,
+        // прочитавший про ступени в панели, попробует `--cpu 2` — и без этих
+        // флагов получит «неизвестный параметр», то есть ответ про синтаксис
+        // вместо ответа про причину.
+        .option("--cpu <number>", "выделенный инстанс: заказывается в панели", (v) => parseInt(v, 10))
+        .option("--ram <mb>", "выделенный инстанс: заказывается в панели", (v) => parseInt(v, 10))
+        .option("--dedicated", "выделенный инстанс: заказывается в панели")).action(async (name, opts) => dbCreateCmd(name, { ...opts, json: program.opts().json }));
     withOrg(db
         .command("connect <database>")
-        .description("Подключить проект к базе: строка подключения приедет в его переменные.")
+        .description("Подключить проект к базе: строка подключения приедет в его "
+        + "переменные, а домены проекта станут разрешёнными для Data API.")
         .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")).action(async (database, opts) => dbConnectCmd(database, { ...opts, json: program.opts().json }));
     withOrg(db
-        .command("sql <database>")
+        .command("disconnect <database>")
+        .description("Отвязать проект от базы: переменная уйдёт следующим деплоем, "
+        + "роль проекта удалится, домены перестанут быть разрешёнными для Data API.")
+        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")).action(async (database, opts) => dbDisconnectCmd(database, { ...opts, json: program.opts().json }));
+    withOrg(db
+        // 🚨 ЗАПРОС МОЖНО ПИСАТЬ ПРОСТО СЛЕДОМ ЗА ИМЕНЕМ БАЗЫ. Раньше `-c` был
+        // ОБЯЗАТЕЛЕН, и `layero db sql моя-база "select 1"` отвечал
+        // «required option -c, --command not specified» — то есть отказывал на
+        // самой очевидной форме записи. Так эта команда и записана в приёмке
+        // (C6), и так её пишет всякий, кто помнит psql.
+        .command("sql <database> [sql]")
         .description("Выполнить SQL в базе. Скрипт из нескольких операторов — одной транзакцией.")
-        .requiredOption("-c, --command <sql>", "запрос или скрипт")).action(async (database, opts) => dbSqlCmd(database, { ...opts, json: program.opts().json }));
+        .option("-c, --command <sql>", "запрос или скрипт")).action(async (database, sql, opts) => dbSqlCmd(database, {
+        ...opts,
+        // Явный `-c` выигрывает: он написан намеренно, а позиционный аргумент
+        // мог прилететь из истории команд.
+        command: opts.command ?? sql,
+        json: program.opts().json,
+    }));
     const analytics = program
         .command("analytics")
         .description("Яндекс.Метрика: подключение и статистика сайта.");

package/dist/commands/db.js

@@ -11,6 +11,7 @@
 // командах.
 import chalk from "chalk";
 import { ApiClient } from "../api.js";
+import { dashboardOrigin } from "../urls.js";
 import { loadConfig } from "../config.js";
 import { loadProjectConfig } from "../project-config.js";
 import { LayeroError, detectMode, emit } from "../agent.js";
@@ -44,6 +45,40 @@ function gb(bytes) {
         return "—";
     return `${(bytes / 1024 / 1024 / 1024).toFixed(2)} ГБ`;
 }
+/**
+ * Что сказать про деньги у этой базы. Пусто — платить не за что.
+ *
+ * 🚨 КАЖДОМУ СОСТОЯНИЮ СВОЯ ФРАЗА, И ЭТО НЕ УКРАШЕНИЕ. У базы с закрытым
+ * доступом «спишем 3 октября» — неправда: списывать уже пробовали и не вышло.
+ * Одна строка на все состояния была бы верной ровно в одном из них.
+ *
+ * Даты приходят от сервера уже посчитанными: правила лестницы живут там, и
+ * вторая их реализация в CLI разошлась бы с панелью молча.
+ */
+export function billingLine(d) {
+    const b = d.billing;
+    if (!b)
+        return null;
+    const rub = (b.price_month_kopecks / 100).toLocaleString("ru-RU");
+    const when = (iso) => iso ? new Date(iso).toLocaleDateString("ru-RU", { day: "numeric", month: "long" }) : null;
+    if (b.status === "suspended") {
+        const gone = when(b.terminate_at);
+        return chalk.red(gone
+            ? `${rub} ₽/мес · доступ закрыт за неоплату, удалим ${gone}`
+            : `${rub} ₽/мес · доступ закрыт за неоплату`);
+    }
+    if (b.status === "past_due") {
+        const till = when(b.paid_until);
+        return chalk.yellow(till
+            ? `${rub} ₽/мес · оплата не прошла, работает по ${till}`
+            : `${rub} ₽/мес · оплата не прошла`);
+    }
+    const next = when(b.next_charge_at);
+    if (next)
+        return chalk.dim(`${rub} ₽/мес · спишем ${next}`);
+    const till = when(b.paid_until);
+    return chalk.dim(till ? `${rub} ₽/мес · оплачено по ${till}` : `${rub} ₽/мес`);
+}
 export async function dbListCmd(opts) {
     const mode = detectMode();
     const api = new ApiClient(await loadConfig());
@@ -59,22 +94,107 @@ export async function dbListCmd(opts) {
     }
     for (const d of list) {
         const api_on = d.api_enabled ? chalk.green("API") : chalk.dim("без API");
+        // 🚨 РАЗМЕЩЕНИЕ И ВЕРСИЯ — В СТРОКЕ, А НЕ ТОЛЬКО В `--json`. Их не было
+        // вовсе: по выводу нельзя было отличить базу из тарифа от выделенного
+        // инстанса за 7750 ₽ в месяц и узнать, какой там Postgres. Панель обе
+        // вещи показывает, а приёмка (C2) спрашивает именно их.
+        const place = d.placement === "dedicated"
+            ? "выделенный"
+            : d.placement === "external"
+                ? "свой сервер"
+                : "Shared";
+        const version = d.pg_version ? `PG${d.pg_version}` : chalk.dim("PG—");
         console.log(`${chalk.bold(d.name)}  ${chalk.dim(d.name_slug ?? "")}  ${d.status}  ` +
+            `${place}  ${version}  ` +
             `${api_on}  проектов: ${d.projects_count}  ${gb(d.size_bytes)} из ${gb(d.quota_bytes)}`);
+        // 🚨 СРОК ОПЛАТЫ — ОТДЕЛЬНОЙ СТРОКОЙ, А НЕ ХВОСТОМ ПЕРВОЙ. Строка и так
+        // на пределе ширины терминала, а это единственное, что решает, будет база
+        // работать через неделю. Хвост, уезжающий за край, — то же молчание.
+        const money = billingLine(d);
+        if (money)
+            console.log(`  ${money}`);
+    }
+}
+/** Ждёт, пока база станет рабочей. `false` — не дождались за отведённое время.
+ *
+ * Опрос, а не подписка: ручки событий у нас нет, а держать соединение ради
+ * одной строки состояния незачем. Потолок ожидания — своё число, а не «пока
+ * не надоест»: выделенный кластер поднимается 7–13 минут, и повесить терминал
+ * на всё это время нельзя. Не дождались — говорим об этом прямо.
+ */
+async function waitUntilReady(api, org, name, timeoutMs = 90_000) {
+    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;
+            if (mine && mine.status === "failed")
+                return false;
+        }
+        catch {
+            // Сеть моргнула — это не повод объявлять базу несозданной.
+        }
     }
+    return false;
 }
 export async function dbCreateCmd(name, opts) {
     const mode = detectMode();
-    const api = new ApiClient(await loadConfig());
+    // 🚨 `--gb` НЕ ДЕЛАЛ НИЧЕГО, И МОЛЧАНИЕ БЫЛО ХУЖЕ ОТКАЗА. Поле уезжало на
+    // сервер, а тот его не читает ни одним путём создания: у Shared объём задаёт
+    // тариф, у выделенного — диск ступени. Человек называл число, получал базу
+    // другого размера и не знал почему (приёмка C9).
+    if (opts.gb != null) {
+        throw new LayeroError("gb_not_supported", "объём базы так не выбирается", "у базы из тарифа объём задан тарифом, у выделенного инстанса — диском " +
+            "ступени: закажите нужную ступень в панели");
+    }
+    // 🚨 ПЛАТНЫЙ ЗАКАЗ ИЗ ТЕРМИНАЛА НЕВОЗМОЖЕН, И СКАЗАТЬ ОБ ЭТОМ НАДО СЛОВАМИ.
+    // Дело не в лени: у заказа выделенного инстанса есть цена и заморозка денег
+    // на карте. Карту в терминале не привяжешь, сумму подтвердить негде, а
+    // «списали, потому что вы набрали команду» — не тот способ брать деньги.
+    //
+    // Отказ называет причину и ведёт туда, где заказ возможен. Молчаливое
+    // создание Shared вместо выделенного было бы хуже отказа: человек получил бы
+    // не то, что просил, и узнал бы об этом по нехватке мощности.
+    const config = await loadConfig();
+    if (opts.dedicated || opts.cpu != null || opts.ram != null) {
+        throw new LayeroError("dedicated_needs_panel", "выделенный инстанс из терминала не заказывается", "у него есть цена и заморозка денег на карте, а подтвердить сумму в " +
+            "терминале негде. Закажите в панели: " +
+            `${dashboardOrigin(config.apiUrl)}/databases?new=1 — там видны ` +
+            "ступени, цена и дата следующего списания");
+    }
+    const api = new ApiClient(config);
     const org = await orgOf(api, opts);
-    const created = await api.createDatabase(org, { name, quota_gb: opts.gb });
+    const created = await api.createDatabase(org, {
+        name,
+        // 🚨 ФЛАГА «БЕЗ НАПОЛНЕНИЯ» БОЛЬШЕ НЕТ. Он существовал, пока пресет
+        // заводил три таблицы с примерами: человек со своей схемой получал чужие
+        // таблицы молча, и отказаться было нечем. Тестовых таблиц в пресете не
+        // осталось — он настраивает роли, функцию состояния и умолчания прав,
+        // и вычищать после него нечего. Значит и отказываться не от чего.
+    });
     // Пароль отдаётся ОДИН РАЗ — второй раз его не покажет никто, только
     // ротация. Поэтому он и в JSON-режиме, и в терминале.
     if (mode.json || opts.json) {
         emit({ event: "database_created", org, name, ...created });
         return;
     }
-    console.log(`${chalk.green("✓")} база «${name}» заведена в организации ${org}`);
+    // 🚨 БАЗА ЕЩЁ НЕ ГОТОВА В ЭТОТ МОМЕНТ. Ручка стала асинхронной: она пишет
+    // намерение и возвращается, подготовка идёт минуты. Печатать «заведена» и
+    // строку подключения сразу значит отправить человека к `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) {
+        console.log(`${chalk.green("✓")} база «${name}» готова в организации ${org}`);
+    }
+    else {
+        console.log(`${chalk.yellow("!")} база «${name}» ещё готовится — строка подключения ниже ` +
+            "заработает, как только она поднимется");
+    }
     console.log(`\n  ${created.connection_string}`);
     console.log(chalk.dim("\n  Пароль показывается один раз — сохраните строку подключения.\n" +
         "  Ключи Data API для фронтенда: layero data env"));
@@ -95,14 +215,48 @@ export async function dbConnectCmd(ref, opts) {
         emit({ event: "database_connected", org, database: db.name, project: project.slug });
         return;
     }
+    // 🚨 СЛЕДСТВИЙ У СВЯЗИ ДВА, и второе стоило отдельного разбора 09.09.2026.
+    // Кроме строки подключения, связь проект↔база — ЕДИНСТВЕННЫЙ источник списка
+    // разрешённых доменов Data API: представление `data_api_origins` собирает их
+    // из `userdb_roles`. Пока здесь говорилось только про переменные, человек,
+    // у которого сайт отбивался по CORS, не имел ни одной причины связать это со
+    // своей ненажатой командой — а отказ шлюза именно её и советует.
     console.log(`${chalk.green("✓")} проект «${project.slug}» подключён к базе «${db.name}»\n` +
-        chalk.dim("  строка подключения приедет в переменные окружения проекта"));
+        chalk.dim("  строка подключения приедет в переменные окружения проекта\n") +
+        chalk.dim(`  домены проекта разрешены для Data API базы «${db.name}»`));
+}
+export async function dbDisconnectCmd(ref, opts) {
+    // 🚨 ОБРАТНОГО ДЕЙСТВИЯ НЕ БЫЛО ВОВСЕ. `db connect` существовал с самого
+    // начала, а отвязать проект от базы можно было только в панели — при том
+    // что подсказка `env list` прямо звала сделать это командой. Приёмка (A7.6)
+    // спрашивает именно её.
+    const mode = detectMode();
+    const api = new ApiClient(await loadConfig());
+    const org = await orgOf(api, opts);
+    const linked = await loadProjectConfig(process.cwd());
+    const projectRef = opts.project ?? linked?.project_id;
+    if (!projectRef) {
+        throw new LayeroError("project_unknown", "не понятно, какой проект отвязывать от базы", "запустите из каталога проекта или передайте --project <id|slug>");
+    }
+    const project = await api.getProject(projectRef);
+    const db = await pick(api, org, ref);
+    await api.disconnectDatabaseFromProject(org, db.id, project.id);
+    if (mode.json || opts.json) {
+        emit({ event: "database_disconnected", org, database: db.name, project: project.slug });
+        return;
+    }
+    // Обратная сторона той же связи: домены проекта перестают быть разрешёнными.
+    // Молчать об этом — значит отдать человеку сайт, который перестанет отвечать
+    // по причине, названной в другой команде.
+    console.log(`${chalk.green("✓")} проект «${project.slug}» отвязан от базы «${db.name}»\n` +
+        chalk.dim("  переменная уйдёт из окружения следующим деплоем, роль проекта удалена\n") +
+        chalk.dim("  домены проекта больше не разрешены для Data API этой базы"));
 }
 export async function dbSqlCmd(ref, opts) {
     const mode = detectMode();
     const sql = (opts.command ?? "").trim();
     if (!sql) {
-        throw new LayeroError("sql_missing", "нечего выполнять", 'передайте запрос: -c "SELECT 1"');
+        throw new LayeroError("sql_missing", "нечего выполнять", 'передайте запрос следом за именем базы: layero db sql моя-база "select 1"');
     }
     const api = new ApiClient(await loadConfig());
     const org = await orgOf(api, opts);

package/dist/commands/deploy.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import readline from "node:readline/promises";
 import chalk from "chalk";
 import { ApiClient, ApiError, uploadArchive, } from "../api.js";
+import { dashboardOrigin } from "../urls.js";
 import { loadConfig } from "../config.js";
 import { loadProjectConfig, persistProjectLinking, } from "../project-config.js";
 import { packCwd, packDirectory } from "../pack.js";
@@ -70,19 +71,6 @@ export function runtimeTypeOf(raw) {
         return null;
     return RUNTIME_TYPES[raw.trim().toLowerCase()] ?? null;
 }
-function dashboardOrigin(apiUrl) {
-    const override = process.env.LAYERO_DASHBOARD_URL;
-    if (override)
-        return override.replace(/\/+$/, "");
-    try {
-        const u = new URL(apiUrl);
-        u.hostname = u.hostname.replace(/^api\./, "app.");
-        return u.origin;
-    }
-    catch {
-        return "https://app.layero.ru";
-    }
-}
 function projectUrl(apiUrl, projectId) {
     return `${dashboardOrigin(apiUrl)}/projects/${projectId}`;
 }

package/dist/commands/env.js

@@ -24,7 +24,7 @@ export async function envListCmd(opts) {
         emit({
             event: "env_vars",
             project: project.slug,
-            vars: rows.map((r) => ({ key: r.key, length: r.length })),
+            vars: rows.map((r) => ({ key: r.key, length: r.length, managed: !!r.managed })),
         });
         return;
     }
@@ -33,10 +33,21 @@ export async function envListCmd(opts) {
         console.log(chalk.dim("добавить: layero env set KEY=value"));
         return;
     }
+    // 🚨 ПЕРЕМЕННЫЕ ПЛАТФОРМЫ ПОМЕЧЕНЫ, А НЕ ПЕРЕМЕШАНЫ СО СВОИМИ. Список
+    // отвечает на вопрос «что получит моё приложение», и строка подключения к
+    // базе — часть ответа. Но менять её нельзя: она пересобирается из связи
+    // проекта с базой, и предложить правку значило бы пообещать несбыточное.
     for (const r of rows) {
-        console.log(`${r.key}${chalk.dim(`  (${r.length} симв.)`)}`);
+        const tail = r.managed
+            ? chalk.dim(`  (${r.length} симв., ставит платформа)`)
+            : chalk.dim(`  (${r.length} симв.)`);
+        console.log(`${r.key}${tail}`);
     }
     console.log(chalk.dim("\nзначения не показываются — платформа их не отдаёт"));
+    if (rows.some((r) => r.managed)) {
+        console.log(chalk.dim("помеченные «ставит платформа» задаются подключением базы к проекту:"));
+        console.log(chalk.dim("  layero db connect <база>  /  layero db disconnect <база>"));
+    }
 }
 function parsePair(raw) {
     const i = raw.indexOf("=");

package/dist/urls.js

@@ -0,0 +1,21 @@
+/**
+ * Адреса панели, выведенные из адреса API.
+ *
+ * 🚨 ОДНО МЕСТО, А НЕ ПО КОПИИ НА КОМАНДУ. Правило простое — `api.` меняется на
+ * `app.`, — и ровно поэтому его тянет переписать заново там, где понадобилось.
+ * Вторая копия разошлась бы на первом же стенде: переменную `LAYERO_DASHBOARD_URL`
+ * читала бы одна команда, а вторая уводила бы человека на боевую панель.
+ */
+export function dashboardOrigin(apiUrl) {
+    const override = process.env.LAYERO_DASHBOARD_URL;
+    if (override)
+        return override.replace(/\/+$/, "");
+    try {
+        const u = new URL(apiUrl);
+        u.hostname = u.hostname.replace(/^api\./, "app.");
+        return u.origin;
+    }
+    catch {
+        return "https://app.layero.ru";
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "layero",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "description": "Layero CLI \u2014 publish a local site with one command. No git, no GitHub, agent-friendly (Cursor, Claude Code).",
   "license": "MIT",
   "type": "module",