@neetru/cli 2.7.5 → 2.9.1

package/dist/commands/customers.js

@@ -0,0 +1,160 @@
+/**
+ * `neetru customers` — comandos de gestão de customers via CLI.
+ *
+ * Endpoints:
+ *   GET  /api/cli/v1/customers        (list)
+ *   GET  /api/cli/v1/customers/{id}   (get)
+ *   POST /api/cli/v1/customers        (create — pdv #2)
+ *
+ * Customer = empresa/PJ que paga os serviços Neetru (CRM comercial).
+ * Diferente de Tenant = instância do produto para esse customer.
+ *
+ * Plain PT-BR em todas as strings visíveis ao usuário.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { apiRequest } from '../lib/api-client.js';
+import { requireToken, handleApiError, printWriteResult } from '../lib/cli-write.js';
+import { renderTable, fmtTimestamp } from '../lib/render.js';
+import { promptText } from '../lib/pickers.js';
+import { log } from '../utils/logger.js';
+function colorStatus(s) {
+    if (!s)
+        return chalk.dim('—');
+    if (s === 'ativo')
+        return chalk.green(s);
+    if (s === 'suspenso')
+        return chalk.yellow(s);
+    if (s === 'arquivado')
+        return chalk.dim(s);
+    return s;
+}
+export async function runCustomersList(opts = {}) {
+    const token = await requireToken(opts.json);
+    const params = new URLSearchParams();
+    if (opts.status)
+        params.set('status', opts.status);
+    if (opts.search)
+        params.set('search', opts.search);
+    const qs = params.toString();
+    const spinner = opts.json
+        ? null
+        : ora({ text: 'Buscando customers…', color: 'blue' }).start();
+    let res;
+    try {
+        res = await apiRequest(`/api/cli/v1/customers${qs ? `?${qs}` : ''}`, { token });
+        spinner?.stop();
+    }
+    catch (error) {
+        spinner?.fail('Falha ao buscar customers.');
+        handleApiError(error, opts.json);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify({ ok: res.ok, count: res.count, customers: res.customers }));
+        return;
+    }
+    log.heading(`Customers (${res.count})`);
+    renderTable([
+        { header: 'ID', value: (r) => r.id, maxWidth: 24 },
+        { header: 'NOME', value: (r) => r.name ?? '—', maxWidth: 28 },
+        { header: 'EMAIL', value: (r) => r.contactEmail ?? '—', maxWidth: 30 },
+        { header: 'CNPJ/CPF', value: (r) => r.cnpj ?? '—', maxWidth: 18 },
+        { header: 'STATUS', value: (r) => colorStatus(r.status), maxWidth: 14 },
+        { header: 'CRIADO', value: (r) => fmtTimestamp(r.createdAt) },
+    ], res.customers);
+    console.log();
+}
+export async function runCustomersGet(id, opts = {}) {
+    const token = await requireToken(opts.json);
+    if (!id) {
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: false, error: 'missing_input', message: '<id> é obrigatório.' }));
+        }
+        else {
+            log.error('<id> é obrigatório. Use: neetru customers get <id>');
+        }
+        process.exit(1);
+        return;
+    }
+    const spinner = opts.json
+        ? null
+        : ora({ text: `Buscando customer ${id}…`, color: 'blue' }).start();
+    let res;
+    try {
+        res = await apiRequest(`/api/cli/v1/customers/${encodeURIComponent(id)}`, { token });
+        spinner?.stop();
+    }
+    catch (error) {
+        spinner?.fail('Falha ao buscar customer.');
+        handleApiError(error, opts.json);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(res));
+        return;
+    }
+    const c = res.customer ?? {};
+    log.heading(`Customer ${c.name ?? id}`);
+    renderTable([
+        { header: 'CAMPO', value: (r) => r.k, maxWidth: 20 },
+        { header: 'VALOR', value: (r) => r.v, maxWidth: 70 },
+    ], [
+        { k: 'id', v: c.id ?? id },
+        { k: 'nome', v: c.name ?? '—' },
+        { k: 'email', v: c.contactEmail ?? '—' },
+        { k: 'cnpj/cpf', v: c.cnpj ?? '—' },
+        { k: 'razão social', v: c.legalName ?? '—' },
+        { k: 'status', v: colorStatus(c.status) },
+        { k: 'origem', v: c.origin ?? '—' },
+        { k: 'criado', v: fmtTimestamp(c.createdAt) },
+        { k: 'atualizado', v: fmtTimestamp(c.updatedAt) },
+    ]);
+    console.log();
+}
+export async function runCustomersCreate(opts = {}) {
+    const token = await requireToken(opts.json);
+    // Coleta os campos — interativo se não passados como flags.
+    let name = opts.name?.trim() ?? '';
+    if (!name) {
+        name = await promptText('Nome do customer (ex: Mercado X Ltda):', {
+            json: opts.json,
+            required: true,
+            validate: (v) => (v.length >= 2 ? true : 'Mínimo 2 caracteres.'),
+        });
+    }
+    let email = opts.email?.trim() ?? '';
+    if (!email) {
+        email = await promptText('Email de contato:', {
+            json: opts.json,
+            required: true,
+            validate: (v) => (v.includes('@') ? true : 'Email inválido.'),
+        });
+    }
+    // taxId é opcional — CNPJ ou CPF.
+    const taxId = opts.taxId?.trim() || undefined;
+    const spinner = opts.json
+        ? null
+        : ora({ text: 'Criando customer…', color: 'blue' }).start();
+    let res;
+    try {
+        res = await apiRequest('/api/cli/v1/customers', {
+            method: 'POST',
+            token,
+            body: { name, email, taxId },
+        });
+        spinner?.stop();
+    }
+    catch (error) {
+        spinner?.fail('Falha ao criar customer.');
+        handleApiError(error, opts.json);
+    }
+    printWriteResult({ id: res.id, name: res.name, contactEmail: res.contactEmail, status: res.status }, `Customer criado: ${chalk.bold(res.name)} (${res.id})`, opts.json);
+    if (!opts.json) {
+        log.dim(`  ID:     ${res.id}`);
+        log.dim(`  Email:  ${res.contactEmail}`);
+        log.dim(`  Status: ${colorStatus(res.status)}`);
+        log.dim('');
+        log.dim('Próximos passos:');
+        log.dim(`  Criar workspace: neetru workspaces create --customer ${res.id} --product <id>`);
+    }
+}
+//# sourceMappingURL=customers.js.map

package/dist/commands/customers.js.map

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

package/dist/commands/db.d.ts

@@ -1,14 +1,98 @@
+export interface DbListOptions {
+    productId?: string;
+    engine?: string;
+    status?: string;
+    json?: boolean;
+}
+export declare function runDbList(opts?: DbListOptions): Promise<void>;
+export interface DbStatusOptions {
+    json?: boolean;
+}
+export declare function runDbStatus(dbId: string, opts?: DbStatusOptions): Promise<void>;
 export interface DbInitOptions {
+    name?: string;
+    engine?: string;
+    env?: string;
+    productId?: string;
+    yes?: boolean;
+    /** gestovendas #9: saída em JSON para integração CI/automação. */
+    json?: boolean;
+    /**
+     * @deprecated Opção legada removida (D-3). Passar `--out` resulta em exit(1)
+     * com mensagem clara. Mantida na interface só para não quebrar callers que
+     * constroem o objeto — não tem efeito funcional.
+     */
     out?: string;
+    /**
+     * @deprecated Opção legada removida (D-3). Ver nota de `out` acima.
+     */
     force?: boolean;
 }
 export declare function runDbInit(opts?: DbInitOptions): Promise<void>;
-export interface DbMigrateOptions {
-    toVersion: string;
-    fromVersion?: string;
+export interface DbApplyOptions {
+    dbName?: string;
+    env?: string;
+    schemaPath?: string;
+    dryRun?: boolean;
+    yes?: boolean;
+    /** gestovendas #9: saída em JSON para integração CI/automação. */
+    json?: boolean;
+}
+export declare function runDbApply(opts?: DbApplyOptions): Promise<void>;
+export interface DbMigrationsListOptions {
+    dbId?: string;
+    json?: boolean;
+}
+export declare function runDbMigrationsList(opts?: DbMigrationsListOptions): Promise<void>;
+export interface DbMigrationsConfirmOptions {
+    mfa: string;
+    json?: boolean;
+}
+export declare function runDbMigrationsConfirm(migrationId: string, opts: DbMigrationsConfirmOptions): Promise<void>;
+export interface DbBackupsOptions {
+    json?: boolean;
+}
+/**
+ * Lista os backups disponíveis de um banco específico.
+ *
+ * Endpoint: GET /api/cli/v1/db/[id]/backups
+ * Rota implementada em `src/app/api/cli/v1/db/[id]/backups/route.ts`.
+ */
+export declare function runDbBackups(dbId: string, opts?: DbBackupsOptions): Promise<void>;
+export interface DbRestoreOptions {
+    mfa: string;
+    json?: boolean;
 }
-export declare function runDbMigrate(opts: DbMigrateOptions): Promise<void>;
-export interface DbSeedOptions {
-    script?: string;
+/**
+ * Dispara um restore de banco a partir de um backup selecionado interativamente.
+ *
+ * Fluxo:
+ *   1. Lista backups disponíveis via GET /api/cli/v1/db/[id]/backups
+ *   2. Operador escolhe qual backup restaurar
+ *   3. Exige confirmação textual "RESTAURAR" (operação destrutiva)
+ *   4. POST /api/cli/v1/db/[id]/restore com MFA step-up
+ *
+ * Endpoints implementados em:
+ *   GET  src/app/api/cli/v1/db/[id]/backups/route.ts
+ *   POST src/app/api/cli/v1/db/[id]/restore/route.ts
+ */
+export declare function runDbRestore(dbId: string, opts: DbRestoreOptions): Promise<void>;
+export interface DbHostsOptions {
+    json?: boolean;
 }
-export declare function runDbSeed(opts?: DbSeedOptions): Promise<void>;
+/**
+ * Lista as VMs host e quantos bancos de produto cada uma hospeda.
+ *
+ * Usa o endpoint de servers com `?capacity=true&db=true` para incluir
+ * o inventário de bancos por servidor. O Core agrega o campo `databases`
+ * quando `db=true` é passado.
+ *
+ * Endpoint: GET /api/cli/v1/servers?capacity=true&db=true
+ *
+ * NOTA: O parâmetro `db=true` (que instrui o Core a enriquecer cada server
+ * com o array `databases`) não está implementado ainda no endpoint de servers
+ * do Core (GAP: parâmetro db=true em /api/cli/v1/servers ausente). O comando
+ * funciona com a resposta atual — apenas o campo `databases` por server
+ * ficará ausente/vazio até o Core implementar o enriquecimento.
+ */
+export declare function runDbHosts(opts?: DbHostsOptions): Promise<void>;