@neetru/cli 2.3.0 → 2.4.0

package/dist/lib/pickers.js

@@ -0,0 +1,336 @@
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { apiRequest, CliApiError, CliNetworkError } from './api-client.js';
+import { log } from '../utils/logger.js';
+export function isInteractive(opts = {}) {
+    return (!opts.json &&
+        !opts.nonInteractive &&
+        process.env.CI !== 'true' &&
+        Boolean(process.stdin.isTTY) &&
+        Boolean(process.stdout.isTTY));
+}
+function failInput(message, json) {
+    if (json) {
+        console.log(JSON.stringify({ ok: false, error: 'missing_input', message }));
+    }
+    else {
+        log.error(message);
+    }
+    process.exit(1);
+}
+function failLookup(error, json) {
+    if (error instanceof CliApiError) {
+        if (json) {
+            console.log(JSON.stringify({
+                ok: false,
+                error: error.code,
+                status: error.status,
+                message: error.message,
+            }));
+        }
+        else if (error.status === 401) {
+            log.error('Nao autenticado. Execute: neetru login');
+        }
+        else if (error.status === 403) {
+            log.error(`Acesso negado: ${error.message}`);
+        }
+        else {
+            log.error(`Erro do servidor (${error.status}): ${error.message}`);
+        }
+        process.exit(error.status === 401 ? 1 : 2);
+    }
+    if (error instanceof CliNetworkError) {
+        if (json) {
+            console.log(JSON.stringify({ ok: false, error: 'network', message: error.message }));
+        }
+        else {
+            log.error(error.message);
+        }
+        process.exit(2);
+    }
+    if (json) {
+        console.log(JSON.stringify({
+            ok: false,
+            error: 'unknown',
+            message: error instanceof Error ? error.message : String(error),
+        }));
+    }
+    else {
+        log.error(error instanceof Error ? error.message : String(error));
+    }
+    process.exit(2);
+}
+export async function resolveOrPick(opts) {
+    const flagged = opts.fromFlag?.trim();
+    if (flagged)
+        return flagged;
+    if (opts.json) {
+        failInput(`${opts.flagName} e obrigatorio em modo --json.`, true);
+    }
+    let items;
+    try {
+        items = await opts.fetcher();
+    }
+    catch (error) {
+        failLookup(error, opts.json);
+    }
+    if (items.length === 0) {
+        failInput(opts.emptyError, opts.json);
+    }
+    if (items.length === 1) {
+        return opts.getId(items[0]);
+    }
+    if (!isInteractive(opts)) {
+        const available = items
+            .map((item) => `  - ${opts.getId(item)}: ${stripAnsi(opts.format(item))}`)
+            .join('\n');
+        failInput(`Multiplos candidatos encontrados. Passe ${opts.flagName} explicitamente.\nDisponiveis:\n${available}`, opts.json);
+    }
+    const choices = items.map((item) => ({
+        name: opts.format(item),
+        value: opts.getId(item),
+        short: opts.getId(item),
+    }));
+    if (opts.allowManual !== false) {
+        choices.push(new inquirer.Separator());
+        choices.push({ name: chalk.dim('Digitar ID manualmente'), value: '__manual__' });
+    }
+    const answer = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'picked',
+            message: opts.message,
+            choices,
+            pageSize: 12,
+        },
+    ]);
+    if (answer.picked === '__manual__') {
+        return promptText('ID:', { required: true });
+    }
+    return answer.picked;
+}
+export async function promptText(message, opts = {}) {
+    if (!isInteractive(opts)) {
+        if (opts.default !== undefined)
+            return opts.default;
+        if (opts.required === false)
+            return '';
+        failInput(`Informe ${message}`, opts.json);
+    }
+    const answer = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'value',
+            message,
+            default: opts.default,
+            validate: (value) => {
+                const trimmed = value.trim();
+                if (opts.validate)
+                    return opts.validate(trimmed);
+                if (opts.required !== false && trimmed.length === 0)
+                    return 'Obrigatorio.';
+                return true;
+            },
+        },
+    ]);
+    return answer.value.trim();
+}
+export async function promptChoice(message, choices, opts = {}) {
+    if (!isInteractive(opts)) {
+        if (opts.default !== undefined)
+            return opts.default;
+        failInput(`Escolha ${message}`, opts.json);
+    }
+    const answer = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'picked',
+            message,
+            choices,
+            default: opts.default,
+            pageSize: 10,
+        },
+    ]);
+    return answer.picked;
+}
+export async function resolveCustomer(opts = {}) {
+    const flagged = opts.fromFlag?.trim();
+    if (flagged)
+        return flagged;
+    if (!isInteractive(opts))
+        return 'self';
+    const picked = await promptChoice('Cliente do workspace:', [
+        { name: 'Neetru/default interno', value: 'self' },
+        { name: 'Digitar customerId manualmente', value: 'manual' },
+    ], { default: 'self' });
+    if (picked === 'manual') {
+        return promptText('customerId:', { required: true });
+    }
+    return 'self';
+}
+export async function listProducts(token) {
+    const res = await apiRequest('/api/cli/v1/products', { token });
+    return res.products ?? res.items ?? [];
+}
+export async function listTenants(token, filters = {}) {
+    const params = new URLSearchParams();
+    if (filters.product)
+        params.set('product', filters.product);
+    if (filters.status)
+        params.set('status', filters.status);
+    const qs = params.toString();
+    const res = await apiRequest(`/api/cli/v1/tenants${qs ? `?${qs}` : ''}`, { token });
+    return res.tenants ?? res.items ?? [];
+}
+export async function listWorkspaces(token, filters = {}) {
+    return listTenants(token, filters);
+}
+export async function listServers(token, filters = {}) {
+    const params = new URLSearchParams();
+    if (filters.status)
+        params.set('status', filters.status);
+    if (filters.capacity)
+        params.set('capacity', 'true');
+    const qs = params.toString();
+    const res = await apiRequest(`/api/cli/v1/servers${qs ? `?${qs}` : ''}`, { token });
+    return res.servers ?? res.items ?? [];
+}
+export async function listProductDatabases(token, filters = {}) {
+    const params = new URLSearchParams();
+    if (filters.productId)
+        params.set('productId', filters.productId);
+    if (filters.engine)
+        params.set('engine', filters.engine);
+    if (filters.status)
+        params.set('status', filters.status);
+    const qs = params.toString();
+    const res = await apiRequest(`/api/cli/v1/db/list${qs ? `?${qs}` : ''}`, { token });
+    return res.databases ?? res.items ?? [];
+}
+export function productLabel(product) {
+    const name = product.name ?? product.slug ?? product.id;
+    const slug = product.slug ? chalk.dim(`(${product.slug})`) : '';
+    const status = product.status ? chalk.dim(`- ${product.status}`) : '';
+    const team = product.ownerTeam ? chalk.dim(`- ${product.ownerTeam}`) : '';
+    return compact([statusDot(product.status), chalk.bold(name), slug, status, team]).join(' ');
+}
+export async function pickProductId(token, opts = {}) {
+    return resolveOrPick({
+        ...opts,
+        fetcher: () => listProducts(token),
+        format: productLabel,
+        getId: (product) => product.id,
+        message: opts.message ?? 'Escolha o produto:',
+        emptyError: 'Nenhum produto encontrado. Crie com: neetru products create',
+        flagName: '--product',
+    });
+}
+export async function pickProductSlug(token, opts = {}) {
+    return resolveOrPick({
+        ...opts,
+        fetcher: () => listProducts(token),
+        format: productLabel,
+        getId: (product) => product.slug ?? product.id,
+        message: opts.message ?? 'Escolha o produto:',
+        emptyError: 'Nenhum produto encontrado. Crie com: neetru products create',
+        flagName: '--product',
+    });
+}
+export async function pickTenant(token, opts = {}) {
+    return resolveOrPick({
+        ...opts,
+        fetcher: () => listTenants(token, { product: opts.product, status: opts.status }),
+        format: tenantLabel,
+        getId: (tenant) => tenant.id,
+        message: opts.message ?? 'Escolha o tenant:',
+        emptyError: 'Nenhum tenant encontrado no escopo atual.',
+        flagName: '--tenant',
+    });
+}
+export async function pickWorkspace(token, opts = {}) {
+    return resolveOrPick({
+        ...opts,
+        fetcher: () => listWorkspaces(token, { product: opts.product, status: opts.status }),
+        format: workspaceLabel,
+        getId: (workspace) => workspace.id,
+        message: opts.message ?? 'Escolha o workspace:',
+        emptyError: 'Nenhum workspace encontrado no escopo atual.',
+        flagName: '<workspaceId>',
+    });
+}
+export async function pickServer(token, opts = {}) {
+    return resolveOrPick({
+        ...opts,
+        fetcher: () => listServers(token, { status: opts.status, capacity: opts.capacity }),
+        format: serverLabel,
+        getId: (server) => server.id,
+        message: opts.message ?? 'Escolha o server:',
+        emptyError: 'Nenhum server encontrado no escopo atual.',
+        flagName: '--server',
+    });
+}
+export async function pickDatabase(token, opts = {}) {
+    return resolveOrPick({
+        ...opts,
+        fetcher: () => listProductDatabases(token, {
+            productId: opts.productId,
+            engine: opts.engine,
+            status: opts.status,
+        }),
+        format: databaseLabel,
+        getId: (database) => database.id,
+        message: opts.message ?? 'Escolha o banco:',
+        emptyError: 'Nenhum banco encontrado no escopo atual.',
+        flagName: '<id>',
+    });
+}
+function workspaceLabel(workspace) {
+    const name = workspace.name ?? workspace.slug ?? workspace.id;
+    const product = workspace.productId ? chalk.dim(`- product=${workspace.productId}`) : '';
+    const env = workspace.environmentId ? chalk.dim(`- env=${workspace.environmentId}`) : '';
+    const domain = workspace.primaryDomain ?? workspace.temporaryDomain;
+    const domainLabel = domain ? chalk.dim(`- ${domain}`) : '';
+    return compact([statusDot(workspace.status), chalk.bold(name), product, env, domainLabel]).join(' ');
+}
+function tenantLabel(tenant) {
+    const name = tenant.name ?? tenant.slug ?? tenant.id;
+    const product = tenant.productId ? chalk.dim(`- product=${tenant.productId}`) : '';
+    const env = tenant.environmentId ? chalk.dim(`- env=${tenant.environmentId}`) : '';
+    return compact([statusDot(tenant.status), chalk.bold(name), product, env]).join(' ');
+}
+function serverLabel(server) {
+    const name = server.name ?? server.id;
+    const region = server.region ? chalk.dim(`- ${server.region}`) : '';
+    const ip = server.ipAddress ?? server.ip;
+    const ipLabel = ip ? chalk.dim(`- ${ip}`) : '';
+    const ram = server.availableRamMb != null
+        ? chalk.dim(`- ${server.availableRamMb}/${server.totalRamMb ?? '?'}MB`)
+        : '';
+    return compact([statusDot(server.status), chalk.bold(name), region, ipLabel, ram]).join(' ');
+}
+function databaseLabel(database) {
+    const label = database.label ?? database.id;
+    const product = chalk.dim(`- product=${database.productId}`);
+    const engine = database.engine ? chalk.dim(`- ${database.engine}`) : '';
+    const env = database.environment ? chalk.dim(`- env=${database.environment}`) : '';
+    return compact([statusDot(database.status), chalk.bold(label), product, engine, env]).join(' ');
+}
+function statusDot(status) {
+    if (!status)
+        return chalk.dim('-');
+    if (['ativo', 'active', 'online', 'running'].includes(status))
+        return chalk.green('*');
+    if (['suspenso', 'suspended', 'offline', 'failed', 'error'].includes(status))
+        return chalk.red('*');
+    if (['em provisionamento', 'provisioning', 'pending'].includes(status))
+        return chalk.yellow('*');
+    return chalk.dim('*');
+}
+function compact(values) {
+    return values.filter((value) => value.trim().length > 0);
+}
+function stripAnsi(value) {
+    // eslint-disable-next-line no-control-regex
+    return value.replace(/\x1b\[[0-9;]*m/g, '');
+}
+//# sourceMappingURL=pickers.js.map

package/dist/lib/pickers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickers.js","sourceRoot":"","sources":["../../src/lib/pickers.ts"],"names":[],"mappings":"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"}

package/dist/lib/schema-cache.d.ts

@@ -0,0 +1,87 @@
+export interface OpenApiSpec {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    paths?: Record<string, OpenApiPathItem>;
+    components?: {
+        schemas?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    [key: string]: unknown;
+}
+export interface OpenApiPathItem {
+    [method: string]: OpenApiOperation | unknown;
+}
+export interface OpenApiOperation {
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    tags?: string[];
+    parameters?: unknown[];
+    requestBody?: unknown;
+    responses?: Record<string, unknown>;
+    security?: unknown[];
+}
+export interface EndpointEntry {
+    method: string;
+    path: string;
+    summary: string;
+    tags: string[];
+    operationId: string;
+}
+export interface EndpointDetail {
+    method: string;
+    path: string;
+    summary: string;
+    description: string;
+    operationId: string;
+    tags: string[];
+    parameters: unknown[];
+    requestBody: unknown;
+    responses: Record<string, unknown>;
+    security: unknown[];
+}
+/**
+ * Retorna a spec OpenAPI do Neetru Core.
+ *
+ * - Se houver cache válido (< 24h) E `refresh !== true`: retorna o cache.
+ * - Caso contrário: faz fetch de `/api/internal/openapi.json`, atualiza cache e retorna.
+ *
+ * @throws {CliApiError | CliNetworkError} em caso de falha no fetch.
+ */
+export declare function getCachedSchema(refresh?: boolean): Promise<OpenApiSpec>;
+/**
+ * Retorna o caminho e metadados do cache atual (usado por `schema validate`).
+ */
+export declare function getCacheInfo(): {
+    path: string;
+    exists: boolean;
+    ageMs: number | null;
+    stale: boolean;
+};
+/**
+ * Lista todos os endpoints registrados na spec.
+ *
+ * @returns Array de `{method, path, summary, tags, operationId}` ordenado por path+method.
+ */
+export declare function listEndpoints(spec: OpenApiSpec): EndpointEntry[];
+/**
+ * Retorna detalhes completos de um endpoint específico (requestBody, responses, parameters).
+ *
+ * @param spec - Spec OpenAPI
+ * @param method - Método HTTP (case-insensitive, ex: "GET", "post")
+ * @param endpointPath - Path exato (ex: "/api/cli/v1/tenants")
+ * @returns `EndpointDetail` ou `null` se não encontrado.
+ */
+export declare function describeEndpoint(spec: OpenApiSpec, method: string, endpointPath: string): EndpointDetail | null;

package/dist/lib/schema-cache.js

@@ -0,0 +1,134 @@
+/**
+ * Cache local da spec OpenAPI do Neetru Core.
+ *
+ * Salva em `~/.config/neetru-cli/schema.json` (via Conf path) com TTL de 24h.
+ * Se expirado ou `refresh=true`, faz fetch de `/api/internal/openapi.json`.
+ *
+ * Helpers pra IA consumir: `listEndpoints` e `describeEndpoint`.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { apiRequest } from './api-client.js';
+// ---------------------------------------------------------------------------
+// Path de cache
+// ---------------------------------------------------------------------------
+const TTL_MS = 24 * 60 * 60 * 1000; // 24h
+/** Caminho do arquivo de cache — `~/.config/neetru-cli/schema.json`. */
+function getCachePath() {
+    // Respeita XDG_CONFIG_HOME se definido, caso contrário usa $HOME/.config
+    const configHome = process.env.XDG_CONFIG_HOME ?? path.join(os.homedir(), '.config');
+    return path.join(configHome, 'neetru-cli', 'schema.json');
+}
+function readCache() {
+    const p = getCachePath();
+    try {
+        const raw = fs.readFileSync(p, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(spec) {
+    const p = getCachePath();
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    const envelope = { fetchedAt: Date.now(), spec };
+    fs.writeFileSync(p, JSON.stringify(envelope, null, 2), 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// getCachedSchema
+// ---------------------------------------------------------------------------
+/**
+ * Retorna a spec OpenAPI do Neetru Core.
+ *
+ * - Se houver cache válido (< 24h) E `refresh !== true`: retorna o cache.
+ * - Caso contrário: faz fetch de `/api/internal/openapi.json`, atualiza cache e retorna.
+ *
+ * @throws {CliApiError | CliNetworkError} em caso de falha no fetch.
+ */
+export async function getCachedSchema(refresh = false) {
+    if (!refresh) {
+        const cached = readCache();
+        if (cached && Date.now() - cached.fetchedAt < TTL_MS) {
+            return cached.spec;
+        }
+    }
+    const spec = await apiRequest('/api/internal/openapi.json');
+    writeCache(spec);
+    return spec;
+}
+/**
+ * Retorna o caminho e metadados do cache atual (usado por `schema validate`).
+ */
+export function getCacheInfo() {
+    const p = getCachePath();
+    const cached = readCache();
+    if (!cached) {
+        return { path: p, exists: false, ageMs: null, stale: true };
+    }
+    const ageMs = Date.now() - cached.fetchedAt;
+    return { path: p, exists: true, ageMs, stale: ageMs > TTL_MS };
+}
+// ---------------------------------------------------------------------------
+// Helpers de consulta da spec
+// ---------------------------------------------------------------------------
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace'];
+/**
+ * Lista todos os endpoints registrados na spec.
+ *
+ * @returns Array de `{method, path, summary, tags, operationId}` ordenado por path+method.
+ */
+export function listEndpoints(spec) {
+    const results = [];
+    const paths = spec.paths ?? {};
+    for (const [p, pathItem] of Object.entries(paths)) {
+        if (!pathItem || typeof pathItem !== 'object')
+            continue;
+        for (const method of HTTP_METHODS) {
+            const op = pathItem[method];
+            if (!op || typeof op !== 'object')
+                continue;
+            results.push({
+                method: method.toUpperCase(),
+                path: p,
+                summary: op.summary ?? '',
+                tags: op.tags ?? [],
+                operationId: op.operationId ?? '',
+            });
+        }
+    }
+    return results.sort((a, b) => {
+        const pa = a.path.localeCompare(b.path);
+        return pa !== 0 ? pa : a.method.localeCompare(b.method);
+    });
+}
+/**
+ * Retorna detalhes completos de um endpoint específico (requestBody, responses, parameters).
+ *
+ * @param spec - Spec OpenAPI
+ * @param method - Método HTTP (case-insensitive, ex: "GET", "post")
+ * @param endpointPath - Path exato (ex: "/api/cli/v1/tenants")
+ * @returns `EndpointDetail` ou `null` se não encontrado.
+ */
+export function describeEndpoint(spec, method, endpointPath) {
+    const pathItem = (spec.paths ?? {})[endpointPath];
+    if (!pathItem)
+        return null;
+    const op = pathItem[method.toLowerCase()];
+    if (!op)
+        return null;
+    return {
+        method: method.toUpperCase(),
+        path: endpointPath,
+        summary: op.summary ?? '',
+        description: op.description ?? '',
+        operationId: op.operationId ?? '',
+        tags: op.tags ?? [],
+        parameters: op.parameters ?? [],
+        requestBody: op.requestBody ?? null,
+        responses: op.responses ?? {},
+        security: op.security ?? [],
+    };
+}
+//# sourceMappingURL=schema-cache.js.map

package/dist/lib/schema-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-cache.js","sourceRoot":"","sources":["../../src/lib/schema-cache.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neetru/cli",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "type": "module",
   "description": "Neetru Developer Kit — scaffold, AI assistant, publish, build e deploy de produtos SaaS Neetru via Core (VM-based agents)",
   "keywords": [