layero 0.9.4 → 0.10.0

package/dist/commands/db.js

@@ -11,10 +11,11 @@
 // командах.
 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";
-async function orgOf(api, opts) {
+export async function orgOf(api, opts) {
     if (opts.org)
         return opts.org;
     const orgs = await api.listOrganizations();
@@ -26,7 +27,7 @@ async function orgOf(api, opts) {
     throw new LayeroError("org_unknown", `у вас несколько организаций: ${orgs.map((o) => o.slug).join(", ")}`, "укажите нужную: --org <slug>");
 }
 /** База по имени, слагу или id — как её назвал человек. */
-async function pick(api, org, ref) {
+export async function pick(api, org, ref) {
     const list = await api.listDatabases(org);
     const needle = ref.trim().toLowerCase();
     const found = list.find((d) => d.id === ref ||
@@ -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());
@@ -72,6 +107,12 @@ export async function dbListCmd(opts) {
         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` — не дождались за отведённое время.
@@ -109,7 +150,22 @@ export async function dbCreateCmd(name, opts) {
         throw new LayeroError("gb_not_supported", "объём базы так не выбирается", "у базы из тарифа объём задан тарифом, у выделенного инстанса — диском " +
             "ступени: закажите нужную ступень в панели");
     }
-    const api = new ApiClient(await loadConfig());
+    // 🚨 ПЛАТНЫЙ ЗАКАЗ ИЗ ТЕРМИНАЛА НЕВОЗМОЖЕН, И СКАЗАТЬ ОБ ЭТОМ НАДО СЛОВАМИ.
+    // Дело не в лени: у заказа выделенного инстанса есть цена и заморозка денег
+    // на карте. Карту в терминале не привяжешь, сумму подтвердить негде, а
+    // «списали, потому что вы набрали команду» — не тот способ брать деньги.
+    //
+    // Отказ называет причину и ведёт туда, где заказ возможен. Молчаливое
+    // создание 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,
@@ -159,8 +215,42 @@ 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();

package/dist/commands/deploy.js

@@ -3,6 +3,8 @@ import path from "node:path";
 import readline from "node:readline/promises";
 import chalk from "chalk";
 import { ApiClient, ApiError, uploadArchive, } from "../api.js";
+import { looksLikeId } from "../project-ref.js";
+import { dashboardOrigin } from "../urls.js";
 import { loadConfig } from "../config.js";
 import { loadProjectConfig, persistProjectLinking, } from "../project-config.js";
 import { packCwd, packDirectory } from "../pack.js";
@@ -11,7 +13,7 @@ import { detectProject } from "../detect.js";
 import { runDeviceLogin } from "../auth.js";
 import { LayeroError, detectMode, emit, isCiEnv } from "../agent.js";
 import { ensureUsername } from "../username.js";
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+import { claimTokenFor, createClaimable } from "./claim.js";
 const VALID_TYPES = new Set([
     "vite",
     "next",
@@ -70,19 +72,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}`;
 }
@@ -375,21 +364,78 @@ export async function deployCmd(opts) {
             `runtime kinds: ${[...new Set(Object.values(RUNTIME_TYPES))].join(", ")} ` +
             `(aliases: ${Object.keys(RUNTIME_TYPES).join(", ")})`);
     }
+    const cwd = process.cwd();
+    let existing = await loadProjectConfig(cwd);
     let cliCfg = await loadConfig();
+    // Claimable-проект этого запуска (этап 13): событие `claimable` уходит
+    // перед `ready`, когда адрес сайта уже известен.
+    let claimable = null;
     if (!cliCfg.token) {
-        // In CI nobody can open a browser, so the device flow can only end one
-        // way: fifteen minutes of a hung job and then `auth_expired`. Fail
-        // immediately instead, and say what to do — burning a quarter of an hour
-        // of someone's runner to reach a foregone conclusion is not acceptable.
-        if (isCiEnv()) {
+        // Папка уже привязана к claimable-проекту — деплоим его же токеном,
+        // пока заявка жива. Заявка забрана или истекла — платформа ответит 401,
+        // и это станет `auth_expired`: честнее, чем молча завести ещё один.
+        const reuse = claimTokenFor(cliCfg, existing?.project_id);
+        if (reuse) {
+            cliCfg = { ...cliCfg, token: reuse };
+        }
+        else if (opts.claim || (!mode.interactive && !isCiEnv() && opts.yes)) {
+            // 🚨 CI СЮДА НЕ ПОПАДАЕТ НАМЕРЕННО. Раннер без LAYERO_TOKEN — это
+            // забытый секрет, и правильный ответ ему — отказ, а не сайт на
+            // временном адресе, который через 72 часа исчезнет вместе с
+            // «зелёным» прогоном. Явный `--claim` в CI работает.
+            const r = await createClaimable(cliCfg, cwd, {
+                name: opts.name ?? path.basename(cwd),
+            });
+            cliCfg = r.cfg;
+            claimable = {
+                claim_url: r.created.claim_url,
+                expires_at: r.created.expires_at,
+                project_id: r.created.project_id,
+                slug: r.created.slug,
+            };
+            existing = await loadProjectConfig(cwd);
+        }
+        else if (isCiEnv()) {
+            // In CI nobody can open a browser, so the device flow can only end one
+            // way: fifteen minutes of a hung job and then `auth_expired`. Fail
+            // immediately instead, and say what to do — burning a quarter of an hour
+            // of someone's runner to reach a foregone conclusion is not acceptable.
             throw new LayeroError("auth_required", "No credentials in CI. Create a token at https://app.layero.ru/settings/cli " +
                 "and pass it as the LAYERO_TOKEN environment variable.", "set_layero_token");
         }
-        cliCfg = await runDeviceLogin(cliCfg);
+        else {
+            cliCfg = await runDeviceLogin(cliCfg);
+        }
+    }
+    else if (opts.claim) {
+        throw new LayeroError("bad_format", "--claim — деплой без аккаунта, а вход уже выполнен", "уберите --claim: проект создастся в вашем аккаунте; либо `layero logout` перед `--claim`");
     }
     const api = new ApiClient(cliCfg);
-    const cwd = process.cwd();
-    const existing = await loadProjectConfig(cwd);
+    // 🚨 `--branch` У АРХИВНОЙ ЗАГРУЗКИ НЕ РАБОТАЕТ, И МОЛЧАТЬ ОБ ЭТОМ НЕЛЬЗЯ.
+    // Платформа кладёт каждый архив в зарезервированное окружение `cli`, что
+    // бы ни передали (`projects.py`, «Branch targeting»). До 0.10.0 флаг
+    // принимался и игнорировался: агент читал в справке «deploy to a specific
+    // branch's environment», делал `--branch=probe` и заменял живой сайт,
+    // считая, что выложил превью. Теперь — отказ до упаковки, с разной
+    // подсказкой для проекта без репозитория и с ним.
+    if (opts.branch) {
+        let linked = null;
+        try {
+            if (opts.project)
+                linked = await api.resolveProject(opts.project);
+            else if (existing?.project_id)
+                linked = await api.getProject(existing.project_id);
+        }
+        catch {
+            linked = null;
+        }
+        const repo = linked?.repo_full_name && linked.repo_status !== "disconnected" ? linked.repo_full_name : null;
+        throw new LayeroError("branch_unsupported", repo
+            ? `--branch ${opts.branch}: архивная загрузка не попадает в ветку — платформа кладёт её в окружение «cli»`
+            : `--branch ${opts.branch}: у проекта нет подключённого репозитория, а превью-ветки есть только у проектов с репозиторием`, repo
+            ? `изолированное превью — push в ветку «${opts.branch}» репозитория ${repo}; \`layero deploy\` без --branch обновит окружение «cli»`
+            : "превью-ветки есть только у проектов с репозиторием: подключите его — `layero projects create --repo <provider>:<owner/repo>` — и пушьте в ветку; папку без репозитория выкладывает `layero deploy` без --branch");
+    }
     // --- Всё, что требует файловой системы, делаем сами. Остальное — сервер.
     const prebuiltDir = await resolvePrebuiltDir(cwd, opts.prebuilt);
     const setup = prebuiltDir
@@ -448,7 +494,7 @@ export async function deployCmd(opts) {
         // Опечатка в слаге при этом обязана дать 404, а не завести лишний
         // проект с похожим именем: `create_if_missing: false`.
         ...(opts.project
-            ? UUID_RE.test(opts.project)
+            ? looksLikeId(opts.project)
                 ? { project_id: opts.project }
                 : { name: opts.project, create_if_missing: false }
             : existing?.project_id
@@ -650,6 +696,18 @@ export async function deployCmd(opts) {
         if (evicted.length > 0) {
             emit({ event: "preview_evicted", evicted });
         }
+        // Claimable: ссылка «забрать» — ДО `ready`, потому что после `ready`
+        // агент не читает, а без этой ссылки сайт исчезнет через 72 часа.
+        if (claimable) {
+            emit({
+                event: "claimable",
+                project_id: claimable.project_id,
+                slug: claimable.slug,
+                url: liveUrl,
+                claim_url: claimable.claim_url,
+                expires_at: claimable.expires_at,
+            });
+        }
         emit({
             event: "ready",
             url: liveUrl,

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/commands/envs.js

@@ -0,0 +1,44 @@
+import { ApiClient } from "../api.js";
+import { loadConfig } from "../config.js";
+import { loadProjectConfig } from "../project-config.js";
+import { LayeroError, emit } from "../agent.js";
+/**
+ * `layero envs list [--project]` — окружения проекта с адресами.
+ *
+ * Отдельной ручки «environments» в API нет: окружение и ветка — одна
+ * сущность (`environments` в базе, `/projects/{id}/branches` наружу), и
+ * список приходит оттуда. У CLI-проекта это одно окружение `cli`; у проекта
+ * с репозиторием — ветка на окружение. Архивные и снятые с раздачи в список
+ * не входят — так же, как в панели.
+ */
+export async function envsListCmd(opts) {
+    const cfg = await loadConfig();
+    if (!cfg.token) {
+        throw new LayeroError("auth_required", "вход не выполнен", "выполните `layero login` или задайте LAYERO_TOKEN");
+    }
+    const api = new ApiClient(cfg);
+    let ref = opts.project;
+    if (!ref) {
+        const linked = await loadProjectConfig(process.cwd());
+        ref = linked?.project_id;
+    }
+    if (!ref) {
+        throw new LayeroError("project_unknown", "в этой папке нет привязанного проекта", "запустите из папки проекта или передайте --project <id|slug>");
+    }
+    const project = await api.resolveProject(ref);
+    const branches = await api.listBranches(project.id);
+    const productionBranch = project.production_branch_name ?? project.default_branch;
+    emit({
+        event: "environments",
+        project: project.slug,
+        environments: branches.map((b) => ({
+            id: b.id,
+            branch: b.branch_name,
+            url: b.preview_url,
+            hostname: b.hostname,
+            active_deploy_id: b.active_deploy_id,
+            active_deploy_at: b.active_deploy_at ?? null,
+            production: b.branch_name === productionBranch,
+        })),
+    });
+}

package/dist/commands/hooks.js

@@ -1,23 +1,22 @@
-import chalk from "chalk";
 import { ApiClient, ApiError } from "../api.js";
 import { loadConfig } from "../config.js";
 import { loadProjectConfig } from "../project-config.js";
+import { LayeroError, emit } from "../agent.js";
 async function resolveProjectId(opts) {
     if (opts.project) {
-        // Accepts an id directly; UUID format check is server-side.
+        // Принимает id напрямую; форма UUID проверяется на сервере.
         return opts.project;
     }
     const linked = await loadProjectConfig(process.cwd());
     if (linked?.project_id) {
         return linked.project_id;
     }
-    throw new Error("no project linked in cwd — pass --project <id> or run `layero deploy` "
-        + "from a project directory once to link it.");
+    throw new LayeroError("project_unknown", "в этой папке нет привязанного проекта", "передайте --project <id> или запустите `layero deploy` из папки проекта, чтобы привязать её");
 }
 async function makeClient() {
     const cfg = await loadConfig();
     if (!cfg.token) {
-        throw new Error("not logged in. run `layero login` first.");
+        throw new LayeroError("auth_required", "вход не выполнен", "выполните `layero login` или задайте LAYERO_TOKEN");
     }
     return new ApiClient(cfg);
 }
@@ -25,24 +24,22 @@ export async function hooksListCmd(opts) {
     const api = await makeClient();
     const projectId = await resolveProjectId(opts);
     const hooks = await api.listDeployHooks(projectId);
-    if (hooks.length === 0) {
-        console.log("no deploy hooks yet — `layero hooks create <name>` to add one.");
-        return;
-    }
-    for (const h of hooks) {
-        const targetTag = h.target === "production" ? chalk.red("[prod]") : chalk.cyan("[preview]");
-        const branchTag = h.branch ? chalk.dim(`branch=${h.branch}`) : chalk.dim("branch=default");
-        const last = h.last_triggered_at
-            ? `fired ${new Date(h.last_triggered_at).toISOString()}`
-            : "never fired";
-        console.log(`${targetTag} ${chalk.bold(h.name)}  ${branchTag}  ${chalk.dim("(" + last + ")")}`);
-        console.log(`        ${chalk.dim(h.id)}`);
-        console.log(`        ${h.url}`);
-    }
+    emit({
+        event: "hooks",
+        project: projectId,
+        hooks: hooks.map((h) => ({
+            id: h.id,
+            name: h.name,
+            branch: h.branch,
+            target: h.target,
+            url: h.url,
+            last_triggered_at: h.last_triggered_at,
+        })),
+    });
 }
 export async function hooksCreateCmd(name, opts) {
     if (!name || !name.trim()) {
-        throw new Error("name is required: `layero hooks create <name>`");
+        throw new LayeroError("bad_format", "нужно имя хука", "`layero hooks create <имя>`");
     }
     const api = await makeClient();
     const projectId = await resolveProjectId(opts);
@@ -51,17 +48,19 @@ export async function hooksCreateCmd(name, opts) {
         branch: opts.branch ?? null,
         target: opts.prod ? "production" : "preview",
     });
-    const targetTag = hook.target === "production" ? chalk.red("[prod]") : chalk.cyan("[preview]");
-    console.log(`${chalk.green("✓")} created ${targetTag} ${chalk.bold(hook.name)}`);
-    console.log(`  ${chalk.dim(hook.id)}`);
-    console.log(`  ${chalk.bold(hook.url)}`);
-    console.log(chalk.dim("\n  Paste this URL into your CMS / cron / external CI as a POST webhook. "
-        + "Anyone with the URL can fire a build — treat it like a secret. "
-        + "Rotate by deleting and creating a new one."));
+    emit({
+        event: "hook_created",
+        project: projectId,
+        id: hook.id,
+        name: hook.name,
+        branch: hook.branch,
+        target: hook.target,
+        url: hook.url,
+    });
 }
 export async function hooksDeleteCmd(hookId, opts) {
     if (!hookId) {
-        throw new Error("hook id is required: `layero hooks delete <id>`");
+        throw new LayeroError("bad_format", "нужен id хука", "`layero hooks delete <id>`");
     }
     const api = await makeClient();
     const projectId = await resolveProjectId(opts);
@@ -70,11 +69,9 @@ export async function hooksDeleteCmd(hookId, opts) {
     }
     catch (err) {
         if (err instanceof ApiError && err.status === 404) {
-            console.error(chalk.yellow(`no hook ${hookId} on this project (already deleted?)`));
-            process.exitCode = 1;
-            return;
+            throw new LayeroError("hook_not_found", `у проекта нет хука ${hookId} (уже удалён?)`, "`layero hooks list`");
         }
         throw err;
     }
-    console.log(`${chalk.green("✓")} hook ${chalk.dim(hookId)} revoked`);
+    emit({ event: "hook_deleted", project: projectId, id: hookId });
 }