@getxflow/cli 0.1.0 → 0.1.1

package/README.md

@@ -21,6 +21,8 @@ xflow publish
 | `status` / `push` / `pull` | состояние, отправка и получение исходников |
 | `deploy` / `publish` / `rollback` / `deployments` | сборка, публикация, откат, история версий |
 | `functions list` / `functions deploy` | облачные функции проекта из `functions/<имя>/index.ts` |
+| `functions invoke` / `functions logs` | вызвать функцию, посмотреть её падения со стеком |
+| `logs` | ошибки выложенного приложения в браузере |
 | `projects list` / `projects get` / `open` | проекты организации и адреса приложения |
 | `skills` | инструкция о платформе для ИИ-агента (формат [Agent Skills](https://agentskills.io)) |
 

package/dist/bin.js

@@ -12,6 +12,7 @@ const version_1 = require("./version");
 const auth_1 = require("./commands/auth");
 const projects_1 = require("./commands/projects");
 const functions_1 = require("./commands/functions");
+const logs_1 = require("./commands/logs");
 const skills_1 = require("./commands/skills");
 const sources_1 = require("./commands/sources");
 const deploy_1 = require("./commands/deploy");
@@ -65,11 +66,22 @@ async function run(args) {
                 await (0, functions_1.functionsDeploy)(rest);
                 return;
             }
+            if (second === 'invoke') {
+                await (0, functions_1.functionsInvoke)(rest);
+                return;
+            }
+            if (second === 'logs') {
+                await (0, logs_1.functionsLogs)(rest);
+                return;
+            }
             if (second === undefined || second === 'list') {
                 await (0, functions_1.functionsList)();
                 return;
             }
-            throw new errors_1.CliError(`Неизвестная команда: functions ${second}`, 'Есть list и deploy');
+            throw new errors_1.CliError(`Неизвестная команда: functions ${second}`, 'Есть list, deploy, invoke и logs');
+        case 'logs':
+            await (0, logs_1.logs)(rest);
+            return;
         case 'status':
             await (0, sources_1.status)();
             return;

package/dist/commands/functions.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.functionsList = functionsList;
+exports.functionsInvoke = functionsInvoke;
 exports.functionsDeploy = functionsDeploy;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const api_1 = require("../api");
+const args_1 = require("../args");
 const config_1 = require("../config");
 const errors_1 = require("../errors");
 const session_1 = require("../session");
@@ -77,6 +79,64 @@ async function functionsList() {
         fn.error_message ?? fn.invoke_url ?? '',
     ]));
 }
+/** Ответ функции: JSON разворачиваем, прочее отдаём как есть. */
+function prettyBody(text) {
+    try {
+        return JSON.stringify(JSON.parse(text), null, 2);
+    }
+    catch {
+        return text;
+    }
+}
+/**
+ * Вызвать функцию так же, как её вызывает приложение.
+ *
+ * Токен проекта берём из карточки на платформе, а не из локального `.env`: в
+ * свежем клоне файла нет вовсе, а команда должна работать сразу после link.
+ */
+async function functionsInvoke(args) {
+    const { config } = (0, config_1.requireProject)();
+    const client = (0, session_1.connect)(config);
+    const name = args.words[1];
+    if (!name)
+        throw new errors_1.CliError('Нужно имя функции', 'Что выложено: xflow functions list');
+    const card = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}`);
+    const fn = card.functions.find((item) => item.name === name);
+    if (!fn || !fn.invoke_url) {
+        throw new errors_1.CliError(`Функция ${name} не выложена`, card.functions.length > 0
+            ? `Выложены: ${card.functions.map((item) => item.name).join(', ')}`
+            : `Выкатить: xflow functions deploy ${name}`);
+    }
+    const data = (0, args_1.flagString)(args, 'data');
+    const method = ((0, args_1.flagString)(args, 'method') ?? (data ? 'POST' : 'GET')).toUpperCase();
+    const sendsBody = method !== 'GET' && method !== 'HEAD';
+    const started = Date.now();
+    let response;
+    try {
+        response = await fetch(fn.invoke_url, {
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Project-Token': card.project_token ?? '',
+            },
+            body: sendsBody ? (data ?? '{}') : undefined,
+            // У функции свой потолок в 30 секунд: ждём чуть дольше, чтобы увидеть её
+            // собственный таймаут, а не свой.
+            signal: AbortSignal.timeout(40_000),
+        });
+    }
+    catch (e) {
+        throw new errors_1.CliError(`Функция не ответила: ${e instanceof Error ? e.message : String(e)}`, 'Проверьте, что она выложена: xflow functions list');
+    }
+    const elapsed = Date.now() - started;
+    const text = await response.text();
+    (0, ui_1.note)((0, ui_1.dim)(`${response.status} ${response.statusText} за ${elapsed} мс`));
+    if (text)
+        (0, ui_1.out)(prettyBody(text));
+    if (!response.ok) {
+        throw new errors_1.CliError(`Функция ответила ${response.status}`, `Стек и вывод консоли: xflow functions logs ${name}`);
+    }
+}
 async function functionsDeploy(args) {
     const { root, config } = (0, config_1.requireProject)();
     const client = (0, session_1.connect)(config);

package/dist/commands/logs.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logs = logs;
+exports.functionsLogs = functionsLogs;
+const api_1 = require("../api");
+const args_1 = require("../args");
+const config_1 = require("../config");
+const session_1 = require("../session");
+const ui_1 = require("../ui");
+const DEFAULT_LIMIT = 10;
+/** Стек с хвостом консоли бывает длинным: показываем начало, оно и есть причина. */
+const STACK_MAX_LINES = 14;
+function stamp(iso) {
+    const date = new Date(iso);
+    const pad = (value) => String(value).padStart(2, '0');
+    return `${pad(date.getDate())}.${pad(date.getMonth() + 1)} ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
+}
+async function fetchLogs(source, name, args) {
+    const { config } = (0, config_1.requireProject)();
+    const client = (0, session_1.connect)(config);
+    const query = new URLSearchParams({ source, limit: String((0, args_1.flagNumber)(args, 'limit') ?? DEFAULT_LIMIT) });
+    if (name)
+        query.set('name', name);
+    const data = await (0, api_1.apiJson)(client, `/api/v1/projects/${config.projectId}/logs?${query.toString()}`);
+    return data.logs;
+}
+/** Свежее — внизу: так последняя ошибка оказывается перед глазами, а не уезжает вверх. */
+function render(rows) {
+    for (const row of [...rows].reverse()) {
+        const label = row.source === 'function' ? (row.function ?? 'функция') : 'браузер';
+        (0, ui_1.out)(`${(0, ui_1.dim)(stamp(row.timestamp))}  ${(0, ui_1.bold)(label)}  ${row.message}`);
+        if (row.stack) {
+            const lines = row.stack.split('\n');
+            for (const line of lines.slice(0, STACK_MAX_LINES))
+                (0, ui_1.out)((0, ui_1.dim)(`    ${line}`));
+            if (lines.length > STACK_MAX_LINES)
+                (0, ui_1.out)((0, ui_1.dim)(`    … ещё ${lines.length - STACK_MAX_LINES} строк`));
+        }
+        (0, ui_1.out)('');
+    }
+}
+async function logs(args) {
+    const rows = await fetchLogs('client', undefined, args);
+    if (rows.length === 0) {
+        (0, ui_1.note)('Ошибок из браузера нет');
+        (0, ui_1.note)((0, ui_1.dim)('  Сюда попадают падения выложенного приложения, а не локального npm run dev'));
+        return;
+    }
+    render(rows);
+}
+async function functionsLogs(args) {
+    const name = args.words[1];
+    const rows = await fetchLogs('function', name, args);
+    if (rows.length === 0) {
+        (0, ui_1.note)(name ? `Функция ${name} не падала` : 'Функции не падали');
+        (0, ui_1.note)((0, ui_1.dim)('  Сюда попадают только неудачные вызовы: успешные ничего не пишут'));
+        return;
+    }
+    render(rows);
+}

package/dist/help.js

@@ -37,8 +37,12 @@ ${(0, ui_1.bold)('Выкладка')}
 ${(0, ui_1.bold)('Функции')}
   xflow functions list            что выложено
   xflow functions deploy [имя]    собрать и выкатить функцию
+  xflow functions invoke <имя> [--data '{"a":1}']
+                                  вызвать функцию и показать ответ
+  xflow functions logs [имя]      падения функций: стек и вывод консоли
 
 ${(0, ui_1.bold)('Справочное')}
+  xflow logs [--limit N]          ошибки выложенного приложения в браузере
   xflow projects list             проекты организации
   xflow projects get [id]         карточка проекта
   xflow open [--live]             открыть приложение в браузере
@@ -52,6 +56,35 @@ ${(0, ui_1.bold)('Окружение')}
 Подробнее о команде: xflow help <команда>`);
 }
 const TOPICS = {
+    logs: `${(0, ui_1.bold)('xflow logs')} и ${(0, ui_1.bold)('xflow functions logs')} — ошибки проекта
+
+Один поток на проект: падения выложенного приложения в браузере и падения
+облачных функций. Хранятся последние 200 записей, дальше вытесняются.
+
+  --limit N          сколько показать (по умолчанию 10)
+
+Функция сообщает о падении сама: свои логи Yandex наружу отдаёт только по gRPC,
+поэтому обёртка ловит исключение, уносит вместе с ним хвост консоли (последние 40
+строк ${(0, ui_1.bold)('console.log')} этого вызова) и отправляет на платформу. Успешные вызовы не
+пишут ничего: иначе каждый запрос платил бы за это задержкой.
+
+Не попадёт сюда: падение на старте модуля (функция не успевает дойти до обёртки),
+превышение 30 секунд и нехватка памяти. Такое видно ответом на
+${(0, ui_1.bold)('xflow functions invoke')}.
+
+Ошибки браузера собирает ${(0, ui_1.bold)('src/utils/error-logger.ts')} шаблона и только с
+выложенных адресов: локальный ${(0, ui_1.bold)('npm run dev')} сюда не пишет.`,
+    invoke: `${(0, ui_1.bold)('xflow functions invoke')} <имя> — вызвать функцию
+
+Вызывает так же, как её вызывает приложение: с заголовком X-Project-Token.
+Токен берётся из карточки проекта на платформе, локальный .env не нужен.
+
+  --data '{"a":1}'   тело запроса (по умолчанию метод становится POST)
+  --method GET       другой метод
+
+Печатает статус, время ответа и тело. Ненулевой код возврата на статусе 4xx и
+5xx: в CI такой вызов должен ронять шаг. Причину падения показывает
+${(0, ui_1.bold)('xflow functions logs <имя>')}.`,
     skills: `${(0, ui_1.bold)('xflow skills')} — инструкция о платформе для ИИ-агента
 
 Кладёт файл в формате Agent Skills (agentskills.io): что такое XFlow, как выкладывать

package/dist/version.js

@@ -6,6 +6,6 @@ exports.DEFAULT_API_URL = exports.CLI_VERSION = void 0;
  * рантайме нельзя, после сборки он лежит на уровень выше dist и в бандл не
  * попадает.
  */
-exports.CLI_VERSION = '0.1.0';
+exports.CLI_VERSION = '0.1.1';
 /** Адрес платформы по умолчанию. Переопределяется XFLOW_API_URL и полем `api` в xflow.json. */
 exports.DEFAULT_API_URL = 'https://app.getxflow.com';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getxflow/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI платформы XFlow: синхронизация кода, деплой и публикация приложений",
   "license": "UNLICENSED",
   "engines": {

package/skills/xflow/SKILL.md

@@ -43,6 +43,12 @@ with `xflow functions deploy` (one name to deploy a single function, no name for
 list what is live with `xflow functions list`. The handler returns
 `{ statusCode, body }` where `body` is a JSON string.
 
+Debugging a deployed function is two commands: `xflow functions invoke <name>` calls it
+the way the app does and prints status, timing and body (`--data '{"a":1}'` sends a body),
+and `xflow functions logs <name>` shows the failures, each with its stack and the console
+output of that call. Only failed calls are logged, so an empty output means the function
+never crashed, not that logging is broken.
+
 Calls from the app must carry the `X-Project-Token` header; the token is already in
 the app environment as `VITE_XFLOW_PROJECT_TOKEN`. Treat a function as a public API:
 that token ships inside the frontend bundle.
@@ -89,9 +95,13 @@ list of organization members: that is what `user-picker` is built on.
 
 ## Errors from a deployed app
 
-Client-side failures on deployed addresses show up in the platform: open the project,
-section «Облако» (Cloud), tab «Логи» (Logs). Unhandled errors, rejected promises and
-5xx responses land there. The last 200 records per project are kept.
+`xflow logs` prints what broke in the browser on deployed addresses: unhandled errors,
+rejected promises and 5xx responses. The same stream, functions included, is in the
+platform UI: open the project, section «Облако» (Cloud), tab «Логи» (Logs). The last 200
+records per project are kept.
+
+Local `npm run dev` does not report anything: these logs exist for what you cannot open
+in your own devtools.
 
 ## Environment