layero 0.8.12 → 0.8.14

package/dist/api.js

@@ -59,6 +59,20 @@ export class ApiClient {
             organization_slug: input.organization_slug,
         });
     }
+    /**
+     * Открыть сессию деплоя (AGENT-01/04).
+     *
+     * Один вызов вместо пяти: платформа сама решает, создавать ли проект,
+     * применяет настройку и выдаёт адрес для загрузки архива. `commit_sha`
+     * здесь не передаём — он известен только после упаковки, а паковать до
+     * проверки прав значит зря жечь время пользователя на отказе.
+     */
+    createDeploySession(input) {
+        return this.request("POST", "/deploy-sessions", input);
+    }
+    startDeploySession(sessionId, input) {
+        return this.request("POST", `/deploy-sessions/${sessionId}/start`, input);
+    }
     initUpload(projectId) {
         return this.request("POST", `/projects/${projectId}/uploads`);
     }
@@ -83,6 +97,85 @@ export class ApiClient {
     probeEnvironment(environmentId) {
         return this.request("GET", `/environments/${environmentId}/probe`);
     }
+    /** Одна сборка. Нужна, чтобы узнать её окружение для probe. */
+    getDeploy(deployId) {
+        return this.request("GET", `/deploys/${deployId}`);
+    }
+    /**
+     * Диагностика деплоя (AGENT-07): разобранная причина + окрестность
+     * ошибки. Не сырой лог — платформа уже выбрала из него значимое.
+     */
+    getDeployDiagnosis(deployId) {
+        return this.request("GET", `/deploys/${deployId}/diagnosis`);
+    }
+    getRuntimeLogs(deployId, tail = 100) {
+        return this.request("GET", `/deploys/${deployId}/runtime/logs?tail=${tail}`);
+    }
+    // --- Переменные окружения (AGENT-13) --------------------------------
+    /**
+     * Платформа отдаёт маску, длину и короткий префикс — plaintext не
+     * возвращается ни при каких условиях.
+     */
+    listEnvVars(projectId) {
+        return this.request("GET", `/projects/${projectId}/env`);
+    }
+    /**
+     * Значение `null` = «оставить как есть». Благодаря этому добавить одну
+     * переменную можно, не читая остальные, — то есть не имея доступа к
+     * чужим секретам.
+     */
+    replaceEnvVars(projectId, vars) {
+        return this.request("PUT", `/projects/${projectId}/env`, { vars });
+    }
+    // --- Метрика (AGENT-12) ---------------------------------------------
+    getMetrikaIntegration(projectId) {
+        return this.request("GET", `/projects/${projectId}/integrations/metrika`);
+    }
+    /**
+     * Возвращает ссылку на OAuth Яндекса. Открыть её должен ЧЕЛОВЕК —
+     * ни CLI, ни агент за него авторизоваться не могут.
+     */
+    connectMetrika(projectId, branch) {
+        return this.request("POST", `/projects/${projectId}/integrations/metrika/connect`, branch ? { branch_name: branch } : {});
+    }
+    getMetrikaStats(projectId, period = "7d") {
+        return this.request("GET", `/projects/${projectId}/integrations/metrika/stats?period=${encodeURIComponent(period)}`);
+    }
+    disconnectMetrika(projectId) {
+        return this.request("DELETE", `/projects/${projectId}/integrations/metrika`);
+    }
+    // --- Замеры (AGENT-11) ----------------------------------------------
+    /** Запустить замер активного деплоя. Не ждёт: прогон асинхронный. */
+    startPerfCheck(projectId) {
+        return this.request("POST", `/projects/${projectId}/perf-check`);
+    }
+    /** Результат последнего замера со сравнением с предыдущим деплоем. */
+    getPerfCheck(projectId) {
+        return this.request("GET", `/projects/${projectId}/perf-check`);
+    }
+    // --- Домены (AGENT-09) ---------------------------------------------
+    listDomains(projectId) {
+        return this.request("GET", `/projects/${projectId}/domains`);
+    }
+    /**
+     * Схему и путь бэкенд стрипает сам, так что вставленный из адресной
+     * строки `https://shop.example.com/page` доедет как `shop.example.com`.
+     */
+    addDomain(projectId, domain) {
+        return this.request("POST", `/projects/${projectId}/domains`, { domain });
+    }
+    getDomainInstructions(projectId, domainId) {
+        return this.request("GET", `/projects/${projectId}/domains/${domainId}/instructions`);
+    }
+    verifyDomain(projectId, domainId) {
+        return this.request("POST", `/projects/${projectId}/domains/${domainId}/verify`);
+    }
+    makeDomainPrimary(projectId, domainId) {
+        return this.request("POST", `/projects/${projectId}/domains/${domainId}/primary`);
+    }
+    removeDomain(projectId, domainId) {
+        return this.request("DELETE", `/projects/${projectId}/domains/${domainId}`);
+    }
     pollLogs(deployId, afterId) {
         return this.request("GET", `/deploys/${deployId}/logs?after_id=${afterId}`);
     }

package/dist/auth.js

@@ -48,7 +48,7 @@ export async function runDeviceLogin(cfg) {
             cfg.token = poll.token;
             const probe = new ApiClient(cfg);
             const me = await probe.me();
-            cfg.user = { id: me.id, username: me.username, email: me.email };
+            cfg.user = { id: me.id, username: me.username ?? null, email: me.email };
             await saveConfig(cfg);
             if (mode.json) {
                 emit({ event: "authorized", user: me.username ?? me.email ?? me.id });

package/dist/bin/layero.js

@@ -16,6 +16,11 @@ import { hooksCreateCmd, hooksDeleteCmd, hooksListCmd } from "../commands/hooks.
 import { loginCmd } from "../commands/login.js";
 import { orgsListCmd } from "../commands/orgs.js";
 import { initCmd } from "../commands/init.js";
+import { diagnoseCmd, logsCmd } from "../commands/diagnose.js";
+import { perfCheckCmd, perfShowCmd } from "../commands/perf.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";
 import { LayeroError, detectMode, emit } from "../agent.js";
 import { notifyIfOutdated } from "../update-notifier.js";
 // Read version from the shipped package.json (two levels up from dist/bin/).
@@ -144,7 +149,10 @@ async function main() {
     });
     program
         .command("rollback")
-        .description("Re-activate the previous successful deploy on the project's default branch.")
+        .description("Re-activate the previous successful deploy. Since 27 Jul 2026 it also " +
+        "moves the production pointer, so the apex comes back too when it is " +
+        "served by this branch. For a SPECIFIC older deploy use " +
+        "`layero promote <commit-sha>`.")
         .option("--project <id_or_slug>", "target project (default: linked .layero/project.json)")
         .option("--branch <name>", "branch to roll back (default: project's default_branch)")
         .option("--deploy <id_or_sha>", "explicit deploy id or commit sha prefix to roll back to")
@@ -157,6 +165,89 @@ async function main() {
         .action(async (opts) => {
         await rollbackCmd(opts);
     });
+    const env = program
+        .command("env")
+        .description("Переменные окружения проекта. Значения не показываются — платформа их не отдаёт.");
+    const envProject = (c) => c.option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)");
+    envProject(env.command("list").description("Имена переменных и длина значений."))
+        .action(async (opts) => envListCmd({ ...opts, json: program.opts().json }));
+    envProject(env
+        .command("set <pairs...>")
+        .description("Задать переменные: KEY=value. Остальные остаются нетронутыми.")).action(async (pairs, opts) => envSetCmd(pairs, { ...opts, json: program.opts().json }));
+    envProject(env
+        .command("unset <keys...>")
+        .description("Удалить переменные.")
+        .option("-y, --yes", "не спрашивать подтверждение")).action(async (keys, opts) => envUnsetCmd(keys, { ...opts, json: program.opts().json }));
+    const analytics = program
+        .command("analytics")
+        .description("Яндекс.Метрика: подключение и статистика сайта.");
+    const withProject = (c) => c.option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)");
+    withProject(analytics.command("status").description("Подключена ли Метрика и к какой ветке."))
+        .action(async (opts) => analyticsStatusCmd({ ...opts, json: program.opts().json }));
+    withProject(analytics
+        .command("connect")
+        .description("Подключить Метрику. Печатает ссылку — открыть её и разрешить доступ должен человек.")
+        .option("--branch <name>", "ветка, чей адрес получит счётчик (по умолчанию основная)")).action(async (opts) => analyticsConnectCmd({ ...opts, json: program.opts().json }));
+    withProject(analytics
+        .command("stats")
+        .description("Посещаемость: итоги, тренд и топ источников/устройств/страниц.")
+        .option("--period <7d|30d|90d>", "период (по умолчанию 7d)")).action(async (opts) => analyticsStatsCmd({ ...opts, json: program.opts().json }));
+    withProject(analytics
+        .command("disconnect")
+        .description("Отключить Метрику от проекта.")
+        .option("-y, --yes", "не спрашивать подтверждение")).action(async (opts) => analyticsDisconnectCmd({ ...opts, json: program.opts().json }));
+    const perf = program
+        .command("perf")
+        .description("Замер производительности сайта со сравнением с предыдущим деплоем.");
+    perf
+        .command("check")
+        .description("Запустить замер активного деплоя. Прогон асинхронный — с --wait команда дождётся результата.")
+        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")
+        .option("--wait", "дождаться результата (до 4 минут)")
+        .action(async (opts) => perfCheckCmd({ ...opts, json: program.opts().json }));
+    perf
+        .command("show")
+        .description("Показать последний замер и сравнение с предыдущим деплоем.")
+        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")
+        .action(async (opts) => perfShowCmd({ ...opts, json: program.opts().json }));
+    const domains = program
+        .command("domains")
+        .description("Свои домены проекта: привязать, проверить DNS, сделать основным, снять.");
+    const domainOpts = (c) => c.option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)");
+    domainOpts(domains.command("list").description("Показать домены проекта."))
+        .action(async (opts) => domainsListCmd({ ...opts, json: program.opts().json }));
+    domainOpts(domains
+        .command("add <domain>")
+        .description("Привязать домен. Печатает DNS-записи, которые нужно вписать у регистратора; "
+        + "готовности НЕ ждёт — распространение DNS занимает от минут до часа.")).action(async (domain, opts) => domainsAddCmd(domain, { ...opts, json: program.opts().json }));
+    domainOpts(domains.command("verify <domain>").description("Проверить DNS сейчас, не дожидаясь фоновой перепроверки.")).action(async (domain, opts) => domainsVerifyCmd(domain, { ...opts, json: program.opts().json }));
+    domainOpts(domains.command("primary <domain>").description("Сделать домен основным: платформенный адрес станет 301-редиректом на него.")).action(async (domain, opts) => domainsPrimaryCmd(domain, { ...opts, json: program.opts().json }));
+    domainOpts(domains
+        .command("remove <domain>")
+        .description("Снять домен с проекта. Необратимо и рвёт живой трафик; требует токена со scope admin.")
+        .option("-y, --yes", "не спрашивать подтверждение")).action(async (domain, opts) => domainsRemoveCmd(domain, { ...opts, json: program.opts().json }));
+    program
+        .command("diagnose")
+        .description("Разобрать, почему деплой в таком состоянии: причина человеческим языком, "
+        + "окрестность ошибки в логе сборки и состояние приложения. Без --deploy берёт "
+        + "последний неуспешный деплой проекта.")
+        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный в .layero/project.json)")
+        .option("--deploy <id>", "конкретный деплой")
+        .addHelpText("after", "\nПримеры:\n  $ layero diagnose\n  $ layero diagnose --deploy 8da10ee6")
+        .action(async (opts) => {
+        await diagnoseCmd({ ...opts, json: program.opts().json });
+    });
+    program
+        .command("logs")
+        .description("Показать логи деплоя: сборки (по умолчанию) или приложения (--runtime).")
+        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")
+        .option("--deploy <id>", "конкретный деплой")
+        .option("--runtime", "логи запущенного приложения вместо логов сборки")
+        .option("--tail <n>", "сколько последних строк приложения (по умолчанию 100)", (v) => Number(v))
+        .addHelpText("after", "\nПримеры:\n  $ layero logs\n  $ layero logs --runtime --tail 200")
+        .action(async (opts) => {
+        await logsCmd({ ...opts, json: program.opts().json });
+    });
     program
         .command("link <id_or_slug>")
         .description("Link the current directory to an existing project.")
@@ -181,7 +272,10 @@ async function main() {
         .option("--root <dir>", "monorepo: subdirectory inside the repo that the builder treats as the app root (saved on the project; future GitHub-push and hook triggers use the same value)")
         .option("--prod", "deploy to production (replaces apex_hostname's active deploy). Without this flag, deploys go to the project's CLI preview pseudo-branch.")
         .option("--promote", "pin the project apex to this deploy after a successful build (V071). Works for any branch — e.g. `--promote` without --prod publishes a CLI preview straight to production.")
-        .option("--branch <name>", "deploy to a specific branch's environment. Wins over --prod.")
+        .option("--branch <name>", "ACCEPTED BUT IGNORED for direct uploads: the backend files every " +
+        "archive deploy under the reserved `cli` environment. Branch " +
+        "environments come from pushes to a connected repository, not from " +
+        "this flag. Kept for backwards compatibility.")
         .option("--org <slug>", "Layero organization slug for first-time project creation. Defaults to personal; required when you're a member of multiple orgs and want a non-personal home.")
         .addHelpText("after", "\nExamples:\n" +
         "  $ layero deploy                      # preview deploy (CLI pseudo-branch), auto-detect framework\n" +

package/dist/commands/analytics.js

@@ -0,0 +1,167 @@
+import chalk from "chalk";
+import { ApiClient, ApiError } from "../api.js";
+import { loadConfig } from "../config.js";
+import { loadProjectConfig } from "../project-config.js";
+import { LayeroError, detectMode, emit } from "../agent.js";
+async function projectRef(api, opts) {
+    const linked = await loadProjectConfig(process.cwd());
+    const ref = opts.project ?? linked?.project_id;
+    if (!ref) {
+        throw new LayeroError("project_unknown", "не понятно, о каком проекте речь", "запусти из каталога проекта или передай --project <id|slug>");
+    }
+    const p = await api.getProject(ref);
+    return { id: p.id, slug: p.slug };
+}
+export async function analyticsStatusCmd(opts) {
+    const mode = detectMode();
+    const api = new ApiClient(await loadConfig());
+    const project = await projectRef(api, opts);
+    const s = await api.getMetrikaIntegration(project.id);
+    if (mode.json) {
+        emit({
+            event: "analytics_status",
+            connected: s.connected,
+            counter_id: s.counter_id ?? undefined,
+            status: s.status,
+            injection_mode: s.injection_mode,
+            tracked_branch: s.tracked_branch_name ?? undefined,
+        });
+        return;
+    }
+    if (!s.connected) {
+        console.log(chalk.dim(`Метрика к "${project.slug}" не подключена`));
+        console.log(chalk.dim("подключить: layero analytics connect"));
+        return;
+    }
+    console.log(chalk.green(`Метрика подключена — счётчик ${s.counter_id}`));
+    console.log(chalk.dim(`  ветка: ${s.tracked_branch_name ?? "—"}  ·  режим: ${s.injection_mode}`));
+    if (s.injection_mode === "manual" && s.snippet) {
+        console.log(chalk.yellow("\n  это SSR-проект: счётчик не вшивается автоматически — вставь сниппет в разметку"));
+    }
+    if (s.metrika_url)
+        console.log(chalk.dim(`  ${s.metrika_url}`));
+}
+export async function analyticsConnectCmd(opts) {
+    const mode = detectMode();
+    const api = new ApiClient(await loadConfig());
+    const project = await projectRef(api, opts);
+    let out;
+    try {
+        out = await api.connectMetrika(project.id, opts.branch);
+    }
+    catch (err) {
+        if (err instanceof ApiError && err.status === 503) {
+            throw new LayeroError("oauth_unavailable", "вход через Яндекс сейчас недоступен", "это на нашей стороне — попробуй позже");
+        }
+        if (err instanceof ApiError && err.status === 404) {
+            throw new LayeroError("branch_without_env", `у ветки нет окружения — счётчику некуда указывать`, "сначала задеплой эту ветку, потом подключай Метрику");
+        }
+        throw err;
+    }
+    if (mode.json) {
+        emit({
+            event: "analytics_connect_started",
+            oauth_url: out.oauth_url,
+            // Ждать здесь нечего: между ссылкой и подключением стоит человек,
+            // который открывает её в браузере и жмёт «Разрешить».
+            next_action: "open_url_then_check_status",
+        });
+        return;
+    }
+    console.log("Открой ссылку и разреши доступ — Метрика подключится сама:\n");
+    console.log("  " + chalk.cyan(out.oauth_url));
+    console.log(chalk.dim("\nпотом проверь: layero analytics status"));
+}
+function trend(series) {
+    if (!series || series.length < 4)
+        return null;
+    const half = Math.floor(series.length / 2);
+    const sum = (xs) => xs.reduce((a, b) => a + (b.visits ?? 0), 0);
+    const older = sum(series.slice(0, half));
+    const newer = sum(series.slice(half));
+    if (older === 0 && newer === 0)
+        return null;
+    if (older === 0)
+        return "растёт";
+    const ratio = newer / older;
+    if (ratio >= 1.25)
+        return `растёт (+${Math.round((ratio - 1) * 100)}%)`;
+    if (ratio <= 0.8)
+        return `падает (−${Math.round((1 - ratio) * 100)}%)`;
+    return "ровно";
+}
+export async function analyticsStatsCmd(opts) {
+    const mode = detectMode();
+    const api = new ApiClient(await loadConfig());
+    const project = await projectRef(api, opts);
+    const period = opts.period ?? "7d";
+    const s = await api.getMetrikaStats(project.id, period);
+    if (s.state === "disconnected") {
+        throw new LayeroError("analytics_not_connected", `Метрика к "${project.slug}" не подключена`, "подключить: layero analytics connect");
+    }
+    // Сжимаем для агента: временной ряд превращаем в направление, разбивки
+    // режем до пятёрки. На периоде 90d сырой ответ — это девяносто точек и
+    // десятки строк разбивок, то есть контекст, потраченный на данные,
+    // которые всё равно нужно свернуть в вывод.
+    const b = s.breakdowns ?? {};
+    const top = (xs) => (xs ?? []).slice(0, 5);
+    const compact = {
+        period,
+        state: s.state,
+        totals: s.totals,
+        trend: trend(s.series),
+        sources: top(b.sources),
+        devices: top(b.devices),
+        pages: top(b.pages),
+    };
+    if (mode.json) {
+        emit({ event: "analytics_stats", ...compact });
+        return;
+    }
+    if (s.state === "no_data_yet") {
+        console.log(chalk.dim("счётчик подключён, но визитов пока нет"));
+        return;
+    }
+    const t = s.totals ?? {};
+    console.log(`${chalk.bold(project.slug)} за ${period}`);
+    console.log(`  ${t.visits} визитов · ${t.users} пользователей · ${t.pageviews} просмотров` +
+        (compact.trend ? chalk.dim(`  (${compact.trend})`) : ""));
+    console.log(chalk.dim(`  отказы ${t.bounce_rate}%  ·  среднее время ${Math.round(t.avg_visit_duration)}с`));
+    const line = (label, xs) => xs.length
+        ? console.log(chalk.dim(`  ${label}: `) + xs.map((x) => `${x.name ?? x.label} ${x.visits ?? x.value}`).join(", "))
+        : undefined;
+    line("источники", compact.sources);
+    line("устройства", compact.devices);
+    line("страницы", compact.pages);
+    if (s.state === "stale") {
+        console.log(chalk.yellow("\n  данные могут быть устаревшими: Метрика не ответила"));
+    }
+}
+export async function analyticsDisconnectCmd(opts) {
+    const mode = detectMode();
+    const api = new ApiClient(await loadConfig());
+    const project = await projectRef(api, opts);
+    if (!opts.yes && mode.interactive) {
+        const readline = await import("node:readline/promises");
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            const a = (await rl.question(`отключить Метрику от "${project.slug}"? счётчик перестанет собирать данные [y/N]: `))
+                .trim()
+                .toLowerCase();
+            if (a !== "y" && a !== "yes") {
+                console.log(chalk.yellow("отменено."));
+                return;
+            }
+        }
+        finally {
+            rl.close();
+        }
+    }
+    await api.disconnectMetrika(project.id);
+    if (mode.json) {
+        emit({ event: "analytics_disconnected", project: project.slug });
+        return;
+    }
+    console.log(chalk.green("Метрика отключена"));
+    console.log(chalk.dim("счётчик в Метрике остался — удалить его можно в её интерфейсе"));
+}