layero 0.8.24 → 0.8.25

package/dist/api.js

@@ -89,8 +89,15 @@ export class ApiClient {
     completeSetup(projectId, input) {
         return this.request("POST", `/projects/${projectId}/setup`, input);
     }
-    setRuntimeType(projectId, projectType) {
-        return this.request("POST", `/projects/${projectId}/runtime-type`, { project_type: projectType });
+    /**
+     * Сменить тип проекта.
+     *
+     * `force` — записать вопреки возражению платформы (409). Владелец имеет на
+     * это право: детект ошибается, и репозиторий, который эвристика считает «не
+     * бэкендом», прекрасно работает одним сервисом.
+     */
+    setRuntimeType(projectId, projectType, force = false) {
+        return this.request("POST", `/projects/${projectId}/runtime-type`, { project_type: projectType, force });
     }
     updateProject(projectId, input) {
         return this.request("PATCH", `/projects/${projectId}`, input);
@@ -126,6 +133,16 @@ export class ApiClient {
     listEnvVars(projectId) {
         return this.request("GET", `/projects/${projectId}/env`);
     }
+    /**
+     * Адрес и ПУБЛИЧНЫЙ ключ Data API — те же, что платформа кладёт в сборку.
+     *
+     * Единственное место, где значение приезжает открытым, и это не исключение
+     * из правила выше, а другая природа: публичный ключ уезжает в бандл и виден
+     * любому посетителю сайта. Секретного здесь не бывает.
+     */
+    dataEnv(projectId) {
+        return this.request("GET", `/projects/${projectId}/data-env`);
+    }
     /**
      * Значение `null` = «оставить как есть». Благодаря этому добавить одну
      * переменную можно, не читая остальные, — то есть не имея доступа к

package/dist/bin/layero.js

@@ -15,6 +15,7 @@ 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 { dataEnvCmd } from "../commands/data.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";
@@ -193,6 +194,21 @@ async function main() {
         .command("unset <keys...>")
         .description("Удалить переменные.")
         .option("-y, --yes", "не спрашивать подтверждение")).action(async (keys, opts) => envUnsetCmd(keys, { ...opts, json: program.opts().json }));
+    const data = program
+        .command("data")
+        .description("Data API: адрес и публичный ключ базы для фронтенда.");
+    data
+        .command("env")
+        .description("Показать VITE_/NEXT_PUBLIC_ переменные Data API; --write кладёт их в .env.local.")
+        .option("--project <id_or_slug>", "проект (по умолчанию — залинкованный)")
+        .option("-w, --write", "записать в файл, а не печатать")
+        .option("--file <path>", "имя файла (по умолчанию .env.local)")
+        .addHelpText("after", "\nПримеры:\n" +
+        "  $ layero data env                       # посмотреть\n" +
+        "  $ layero data env --write               # положить в .env.local\n" +
+        "\nОтдаётся только ПУБЛИЧНЫЙ ключ — тот, что и так уезжает в бандл.\n" +
+        "Секретный ключ платформа не хранит и не отдаёт: он для сервера.")
+        .action(async (opts) => dataEnvCmd({ ...opts, json: program.opts().json }));
     const analytics = program
         .command("analytics")
         .description("Яндекс.Метрика: подключение и статистика сайта.");
@@ -278,7 +294,8 @@ async function main() {
     program
         .command("deploy")
         .description("Pack the current directory and deploy it. Framework, build command and output directory are auto-detected.")
-        .option("-t, --type <preset>", "framework override (vite | vitepress | next | astro | cra | sveltekit | nuxt | gatsby | docusaurus | storybook | eleventy | hugo | static)")
+        .option("-t, --type <preset>", "type override — static preset (vite | vitepress | next | astro | cra | sveltekit | nuxt | gatsby | docusaurus | storybook | eleventy | hugo | static) " +
+        "or runtime kind for apps the platform RUNS (node_web | python_web | flask | streamlit | gradio | ssr_next; aliases: express, fastapi, django, node, python)")
         .option("--name <name>", "project name (only used on first deploy)")
         .option("--project <id_or_slug>", "deploy into an existing project, ignoring local config")
         .option("-y, --yes", "non-interactive: accept defaults and skip --prod confirmation")
@@ -304,6 +321,7 @@ async function main() {
         "  $ layero deploy --promote            # preview deploy + pin apex (one-shot publish)\n" +
         "  $ layero deploy --branch=staging     # preview on a specific branch\n" +
         "  $ layero deploy --type vite          # force a framework preset\n" +
+        "  $ layero deploy --type express       # Node backend: platform RUNS it, not serves files\n" +
         "  $ layero deploy --json               # machine-readable output for agents")
         .action(async (opts) => {
         await deployCmd(opts);

package/dist/commands/data.js

@@ -0,0 +1,97 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import chalk from "chalk";
+import { ApiClient } from "../api.js";
+import { loadConfig } from "../config.js";
+import { loadProjectConfig } from "../project-config.js";
+import { LayeroError, detectMode, emit } from "../agent.js";
+const DEFAULT_FILE = ".env.local";
+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", "не понятно, у какого проекта брать переменные Data API", "запусти из каталога проекта или передай --project <id|slug>");
+    }
+    const p = await api.getProject(ref);
+    return { id: p.id, slug: p.slug };
+}
+/**
+ * Дописывает переменные в файл, не трогая чужие строки.
+ *
+ * Перезапись файла целиком была бы проще и однажды стёрла бы чужую строку,
+ * которую человек добавил руками. Свои ключи узнаём по имени и обновляем на
+ * месте — остальное остаётся как было.
+ */
+function mergeEnvFile(previous, vars) {
+    const lines = previous ? previous.split("\n") : [];
+    const remaining = new Map(Object.entries(vars));
+    const out = lines.map((line) => {
+        const match = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=/.exec(line);
+        const name = match?.[1];
+        if (!name)
+            return line;
+        const value = remaining.get(name);
+        if (value === undefined)
+            return line;
+        remaining.delete(name);
+        return `${name}=${value}`;
+    });
+    if (remaining.size) {
+        if (out.length && (out[out.length - 1] ?? "").trim() !== "")
+            out.push("");
+        out.push("# Layero Data API — адрес и публичный ключ (layero data env)");
+        for (const [key, value] of remaining)
+            out.push(`${key}=${value}`);
+        out.push("");
+    }
+    return out.join("\n");
+}
+/** Прикрыт ли файл от коммита. Проверяем буквально то имя, которое пишем. */
+function ignored(cwd, file) {
+    const gitignore = join(cwd, ".gitignore");
+    if (!existsSync(gitignore))
+        return false;
+    const patterns = readFileSync(gitignore, "utf8")
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l && !l.startsWith("#"));
+    return patterns.some((p) => p === file || p === `/${file}` || p === "*.local" || p === ".env*" || p === ".env.*");
+}
+export async function dataEnvCmd(opts) {
+    const mode = detectMode();
+    const api = new ApiClient(await loadConfig());
+    const project = await projectRef(api, opts);
+    const vars = await api.dataEnv(project.id);
+    if (!Object.keys(vars).length) {
+        if (mode.json) {
+            emit({ event: "data_env", project: project.slug, vars: {} });
+            return;
+        }
+        console.log(chalk.dim(`у проекта "${project.slug}" нет базы с включённым Data API\n` +
+            "включить: панель → база → «API» → «Включить API»"));
+        return;
+    }
+    if (mode.json) {
+        emit({ event: "data_env", project: project.slug, vars });
+        return;
+    }
+    const file = opts.file ?? DEFAULT_FILE;
+    if (!opts.write) {
+        // По умолчанию печатаем, а не пишем: команда, которая молча правит файлы в
+        // каталоге, — неприятный сюрприз, особенно у агента.
+        for (const [key, value] of Object.entries(vars))
+            console.log(`${key}=${value}`);
+        console.log(chalk.dim(`\n записать в ${file}:  layero data env --write`));
+        return;
+    }
+    const path = join(process.cwd(), file);
+    const previous = existsSync(path) ? readFileSync(path, "utf8") : "";
+    writeFileSync(path, mergeEnvFile(previous, vars), "utf8");
+    console.log(`${chalk.green("✓")} ${file}: ${Object.keys(vars).length} переменных`);
+    if (!ignored(process.cwd(), file)) {
+        console.log(chalk.yellow(`\n⚠ ${file} не закрыт .gitignore.`) +
+            chalk.dim(`\n  Публичный ключ не секрет — он и так уезжает в бандл. Но файл с таким` +
+                `\n  именем однажды примет настоящий секрет, и тогда будет поздно.` +
+                `\n  Добавьте строку:  echo "${file}" >> .gitignore`));
+    }
+}

package/dist/commands/deploy.js

@@ -31,6 +31,45 @@ const VALID_TYPES = new Set([
     "vitepress",
     "storybook",
 ]);
+/**
+ * Runtime kinds — приложения, которые платформа ЗАПУСКАЕТ, а не раздаёт
+ * файлами.
+ *
+ * 🚨 Их здесь не было вовсе, и это стоило переноса. `--type` принимал только
+ * статические пресеты, а Express-репозиторий детект уверенно опознавал как
+ * `vite` — из-за devDependency `vite`, которую тянет `vitest`. Первый деплой
+ * умирал на «собранный сайт не содержит index.html», и единственным выходом
+ * оставался curl в недокументированную ручку `/projects/<id>/runtime-type`.
+ * Найдено переносом настоящего приложения 16.08.2026.
+ *
+ * Слева — то, что человек напишет, справа — то, что понимает платформа.
+ * Синонимы не украшение: `--type express` пишут чаще, чем `--type node_web`,
+ * и отказ на нём отправляет читать исходники, а не деплоить.
+ */
+const RUNTIME_TYPES = {
+    node_web: "node_web",
+    node: "node_web",
+    express: "node_web",
+    fastify: "node_web",
+    nest: "node_web",
+    nestjs: "node_web",
+    koa: "node_web",
+    python_web: "python_web",
+    python: "python_web",
+    fastapi: "python_web",
+    django: "python_web",
+    flask: "flask",
+    streamlit: "streamlit",
+    gradio: "gradio",
+    ssr_next: "ssr_next",
+    "next-ssr": "ssr_next",
+};
+/** Каноничный runtime-kind по тому, что написал человек, либо `null`. */
+export function runtimeTypeOf(raw) {
+    if (!raw)
+        return null;
+    return RUNTIME_TYPES[raw.trim().toLowerCase()] ?? null;
+}
 function dashboardOrigin(apiUrl) {
     const override = process.env.LAYERO_DASHBOARD_URL;
     if (override)
@@ -177,7 +216,14 @@ async function resolveSetupConfig(cwd, opts, existing) {
         ...(detected.runtime_kind ? { runtime_kind: detected.runtime_kind } : {}),
         ...(detected.ssr_warning ? { ssr_warning: detected.ssr_warning } : {}),
     });
-    const framework_hint = opts.type ?? existing?.framework_hint ?? detected.framework_hint;
+    // ⚠️ Runtime-тип в `framework_hint` не уходит: это разные вопросы. Хинт
+    // отвечает «чем собирать» (vite, next, …), а runtime-kind — «запускать или
+    // раздавать файлами». Положи мы сюда `node_web`, сборщик получил бы имя
+    // фреймворка, которого не существует.
+    const asRuntime = runtimeTypeOf(opts.type);
+    const framework_hint = (asRuntime ? undefined : opts.type) ??
+        existing?.framework_hint ??
+        detected.framework_hint;
     const build_cmd = existing?.build_cmd ?? detected.build_cmd;
     const output_dir = existing?.output_dir ?? detected.output_dir;
     let source;
@@ -195,7 +241,13 @@ async function resolveSetupConfig(cwd, opts, existing) {
         build_cmd,
         output_dir,
         source,
-        ...(detected.runtime_kind ? { runtime_kind: detected.runtime_kind } : {}),
+        // Явный `--type` сильнее детекта: человек уже видел, как детект ошибся,
+        // иначе бы не писал флаг.
+        ...(asRuntime
+            ? { runtime_kind: asRuntime }
+            : detected.runtime_kind
+                ? { runtime_kind: detected.runtime_kind }
+                : {}),
     };
 }
 /**
@@ -313,8 +365,15 @@ async function startWithRepeatedFailureGuard(api, sessionId, commitSha, opts) {
 }
 export async function deployCmd(opts) {
     const mode = detectMode();
-    if (opts.type && !VALID_TYPES.has(opts.type.toLowerCase())) {
-        throw new LayeroError("invalid_type", `unknown --type "${opts.type}"`, `valid types: ${[...VALID_TYPES].join(", ")}`);
+    if (opts.type &&
+        !VALID_TYPES.has(opts.type.toLowerCase()) &&
+        !runtimeTypeOf(opts.type)) {
+        throw new LayeroError("invalid_type", `unknown --type "${opts.type}"`, 
+        // Две группы, а не один список: у них разная судьба. Статический пресет
+        // говорит, ЧЕМ собирать; runtime-тип — что приложение надо ЗАПУСКАТЬ.
+        `static presets: ${[...VALID_TYPES].join(", ")}\n` +
+            `runtime kinds: ${[...new Set(Object.values(RUNTIME_TYPES))].join(", ")} ` +
+            `(aliases: ${Object.keys(RUNTIME_TYPES).join(", ")})`);
     }
     let cliCfg = await loadConfig();
     if (!cliCfg.token) {
@@ -453,6 +512,34 @@ export async function deployCmd(opts) {
             slug: project.slug,
         });
     emit({ event: "setup_applied" });
+    // 🚨 На ПЕРВОЙ настройке хватает `runtime_kind` в сессии, а у уже
+    // существующего проекта побеждает его `project_type` — и `--type node_web`
+    // молча не делал ничего. Ровно здесь человек и упирался: тип приходилось
+    // менять curl'ом в `/projects/<id>/runtime-type`.
+    //
+    // Момент выбран не случайно: сессия создана (значит, id проекта известен),
+    // но архив ещё не упакован и сборка не запущена — флип успевает повлиять на
+    // ту же выкатку.
+    const wantRuntime = runtimeTypeOf(opts.type);
+    if (wantRuntime && project.project_type !== wantRuntime) {
+        try {
+            await api.setRuntimeType(project.id, wantRuntime);
+        }
+        catch (err) {
+            // 409 — платформа возражает: репозиторий не похож на этот тип. Возражение
+            // обязано быть заметным, но не запирающим: человек написал флаг явно, и
+            // спорить с ним мы перестали намеренно (та же логика, что у панели).
+            if (err instanceof ApiError && err.status === 409) {
+                process.stderr.write(chalk.yellow(`! platform disagrees with --type ${wantRuntime}: ${err.body.slice(0, 200)}\n` +
+                    `  applying anyway because you asked explicitly\n`));
+                await api.setRuntimeType(project.id, wantRuntime, true);
+            }
+            else {
+                throw err;
+            }
+        }
+        emit({ event: "runtime_type_applied", project_type: wantRuntime });
+    }
     await persistProjectLinking(cwd, {
         project_id: project.id,
         slug: project.slug,

package/package.json

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