@hadcloud/deploy-cli 0.1.1 → 0.1.3

package/README.md

@@ -0,0 +1,202 @@
+# HAD Deploy CLI
+
+> Crie, publique e acompanhe aplicações no HAD Deploy diretamente pelo terminal — sem expor o provider de infraestrutura.
+
+[![npm version](https://img.shields.io/npm/v/@hadcloud/deploy-cli?color=6d28d9&label=npm)](https://www.npmjs.com/package/@hadcloud/deploy-cli)
+[![Node.js](https://img.shields.io/node/v/@hadcloud/deploy-cli?color=16a34a&label=node)](https://nodejs.org/)
+
+## O que você pode fazer
+
+- Gerenciar projetos: listar, criar, editar e excluir.
+- Criar, editar e excluir aplicações Git, Docker, Dockerfile e templates aprovados.
+- Listar templates públicos e serviços provisionados.
+- Publicar aplicações, iniciar/parar/reiniciar serviços e acompanhar execuções.
+- Consultar status e logs de deploys de aplicações e de templates.
+- Usar tokens com escopo mínimo, inclusive por projeto, em estações locais ou CI/CD.
+
+## Instalação
+
+```bash
+npm install -g @hadcloud/deploy-cli
+```
+
+Confira se a instalação está disponível:
+
+```bash
+had config
+```
+
+## Começo rápido
+
+1. No painel HAD Deploy, abra **CLI & MCP** e gere um token do tipo **CLI**.
+2. Para acesso completo da CLI, selecione os escopos recomendados:
+
+   - `projects:read`, `projects:write`
+   - `apps:read`, `apps:write`
+   - `deployments:read`, `deployments:create`
+   - `logs:read`
+   - `env:write` somente se precisar editar variáveis de templates
+
+3. Faça login:
+
+```bash
+had login --api-url https://api.seu-dominio.com
+```
+
+O token é solicitado sem aparecer no terminal e fica armazenado no cofre do sistema operacional. No Windows, a CLI usa Windows DPAPI.
+
+4. Confira os projetos disponíveis:
+
+```bash
+had projects list
+```
+
+## Atualizar token
+
+Não é preciso executar logout para trocar um token expirado ou criar um token com novos escopos:
+
+```bash
+had token update
+```
+
+A URL de API já configurada é mantida. Você também pode executar `had login` novamente para substituir o token.
+
+Para automação sem prompt:
+
+```bash
+echo "$HAD_DEPLOY_TOKEN" | had token update --token-stdin
+```
+
+> No PowerShell, use: `$env:NOVO_TOKEN | had token update --token-stdin`.
+
+## Projetos
+
+```bash
+# Listar
+had projects list
+
+# Criar
+had projects create "Plataforma de produção" --description "Serviços do cliente"
+
+# Editar
+had projects edit prj_... --name "Produção"
+
+# Excluir — requer confirmação explícita
+had projects delete prj_... --yes
+```
+
+## Aplicações
+
+### Aplicação de um template aprovado
+
+```bash
+# Ver templates disponíveis
+had templates list
+
+# Provisionar n8n em um projeto
+had apps create prj_... --template n8n --region BR-SP-01
+
+# Forma equivalente
+had templates create prj_... n8n --region BR-SP-01
+```
+
+O comando mostra o ID do serviço (`tpl_...`) e, quando o provider já o registrou, o ID da execução. Para acompanhar um deploy de template:
+
+```bash
+had templates services prj_...
+had templates deployments prj_... tpl_...
+had templates status prj_... tpl_... <deployment-id>
+had templates logs prj_... tpl_... <deployment-id> 300
+```
+
+### Aplicação de repositório GitHub
+
+Primeiro conecte sua conta GitHub no painel HAD Deploy. A CLI recebe apenas o identificador da conexão segura já cadastrada — nunca token, senha ou URL Git com credenciais.
+
+```bash
+had apps create prj_... \
+  --name minha-api \
+  --source github \
+  --git-connection git_... \
+  --repository https://github.com/minha-org/minha-api.git \
+  --branch main \
+  --build-type railpack
+```
+
+Fontes aceitas: `github`, `git`, `docker` e `dockerfile`.
+
+```bash
+# Listar aplicações de um projeto
+had apps list prj_...
+
+# Alterar configurações suportadas
+had apps edit prj_... app_... --branch release --build-type dockerfile
+
+# Solicitar deploy de uma aplicação
+had deploy prj_... app_...
+
+# Consultar o deploy interno da aplicação
+had status dep_...
+had logs dep_... 200
+
+# Excluir a aplicação
+had apps delete prj_... app_... --yes
+```
+
+## Gerenciar um serviço de template
+
+```bash
+# Reexecutar um deploy
+had templates deploy prj_... tpl_...
+
+# Atualizar variáveis pelo arquivo local
+had templates edit prj_... tpl_... --env-file .env.production
+
+# Excluir o serviço
+had templates delete prj_... tpl_... --yes
+```
+
+Os IDs de deploy de template pertencem ao provider e não são `dep_...`. Por isso, use `had templates status` e `had templates logs` para eles; `had status` e `had logs` são destinados a aplicações que utilizam a fila interna do HAD Deploy.
+
+## Uso em CI/CD
+
+Prefira variáveis protegidas do provedor de CI. Não grave tokens em `.env` versionado, código-fonte ou logs.
+
+```bash
+export HAD_DEPLOY_API_URL="https://api.seu-dominio.com"
+export HAD_DEPLOY_TOKEN="hd_cli_..."
+
+had projects list
+had deploy prj_... app_...
+```
+
+Quando `HAD_DEPLOY_TOKEN` e `HAD_DEPLOY_API_URL` estão definidos, a CLI não precisa de login interativo nem persiste credenciais locais.
+
+## Segurança
+
+- Gere tokens com o menor conjunto de escopos possível.
+- Para um único projeto, crie um token limitado ao projeto no painel.
+- Tokens limitados a projeto não podem criar novos projetos nem acessar recursos de outro projeto.
+- Comandos destrutivos exigem `--yes`.
+- O manifesto Compose de templates permanece controlado pela plataforma; a CLI não aceita Compose arbitrário.
+- Revogue tokens não utilizados pelo painel HAD Deploy.
+
+## Referência rápida
+
+```text
+had login [--api-url <url>] [--token-stdin]
+had token update [--token-stdin]
+had logout
+had config
+
+had projects list|create|edit|delete
+had apps list|create|edit|delete
+had templates list|create|services|deploy|deployments|status|logs|edit|delete
+had deploy <project-id> <app-id>
+had status <deployment-id>
+had logs <deployment-id> [tail]
+```
+
+## Suporte
+
+Abra o painel HAD Deploy para criar conexões Git, emitir ou revogar tokens e acompanhar a infraestrutura. Ao solicitar suporte, envie o ID público do recurso (`prj_`, `app_`, `tpl_` ou `dep_`) e o horário aproximado da operação — nunca envie o token.

package/dist/index.js

@@ -1,18 +1,34 @@
 #!/usr/bin/env node
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
+import { readFile } from "node:fs/promises";
 import { credentialStatus, isToken, loadCredentials, normalizeApiUrl, removeCredentials, saveCredentials, } from "./credentials.js";
 function usage() {
     console.error(`HAD Deploy CLI
 
 Uso:
   had login [--api-url https://api.exemplo.com] [--token-stdin]
+  had token update [--token-stdin]
   had logout
   had config
   had projects list
+  had projects create <name> [--description <text>]
+  had projects edit <project-id> [--name <name>] [--description <text>]
+  had projects delete <project-id> --yes
   had apps list <project-id>
-  had templates list
   had apps create <project-id> --template <template-id> [--region <region-code>]
+  had apps create <project-id> --name <name> --source github --git-connection <id> --repository <url> [--branch <branch>] [--build-type <type>]
+  had apps edit <project-id> <app-id> [--name <name>] [--branch <branch>] [--build-type <type>]
+  had apps delete <project-id> <app-id> --yes
+  had templates list
+  had templates create <project-id> <template-id> [--region <region-code>]
+  had templates services <project-id>
+  had templates deploy <project-id> <service-id>
+  had templates deployments <project-id> <service-id>
+  had templates status <project-id> <service-id> <deployment-id>
+  had templates logs <project-id> <service-id> <deployment-id> [tail]
+  had templates edit <project-id> <service-id> --env-file <path>
+  had templates delete <project-id> <service-id> --yes
   had deploy <project-id> <app-id>
   had status <deployment-id>
   had logs <deployment-id> [tail]
@@ -36,6 +52,10 @@ async function request(path, init) {
         const payload = (await response.json().catch(() => ({})));
         throw new Error(payload.error?.message ?? `A API retornou HTTP ${response.status}.`);
     }
+    if (response.status === 204 ||
+        response.headers.get("content-length") === "0") {
+        return undefined;
+    }
     return response.json();
 }
 async function prompt(question) {
@@ -89,9 +109,10 @@ async function promptSecret(question) {
 }
 async function login(args) {
     const apiUrlIndex = args.indexOf("--api-url");
+    const configuredApiUrl = (await credentialStatus()).apiUrl;
     const apiInput = apiUrlIndex >= 0
         ? args[apiUrlIndex + 1]
-        : await prompt("URL da API HAD Deploy: ");
+        : (configuredApiUrl ?? (await prompt("URL da API HAD Deploy: ")));
     if (!apiInput)
         throw new Error("A URL da API é obrigatória.");
     const fromStdin = args.includes("--token-stdin");
@@ -133,10 +154,34 @@ function optionValue(args, option) {
         throw new Error(`Informe um valor para ${option}.`);
     return value;
 }
+function requireOption(args, option) {
+    const value = optionValue(args, option);
+    if (!value)
+        throw new Error(`Informe ${option}.`);
+    return value;
+}
+function requireConfirmation(args) {
+    if (!args.includes("--yes")) {
+        throw new Error("Esta operação é destrutiva. Confirme explicitamente com --yes.");
+    }
+}
+function integerOption(args, option) {
+    const value = optionValue(args, option);
+    if (!value)
+        return undefined;
+    const number = Number(value);
+    if (!Number.isInteger(number) || number < 1 || number > 65_535) {
+        throw new Error(`${option} deve ser um número inteiro válido.`);
+    }
+    return number;
+}
 export async function main(args) {
     const [group, action, resourceId, extra] = args;
     if (group === "login")
         return login(args.slice(1));
+    if (group === "token" && action === "update" && !resourceId) {
+        return login(args.slice(2));
+    }
     if (group === "logout" && !action) {
         await removeCredentials();
         console.log("Credenciais locais removidas.");
@@ -156,6 +201,47 @@ export async function main(args) {
         })));
         return;
     }
+    if (group === "projects" && action === "create" && resourceId) {
+        const description = optionValue(args, "--description");
+        const response = await request("/api/v1/projects", {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                "idempotency-key": crypto.randomUUID(),
+            },
+            body: JSON.stringify({
+                name: resourceId,
+                ...(description ? { description } : {}),
+            }),
+        });
+        console.log(`Projeto ${response.project.name} (${response.project.id}) criado: ${response.project.status}`);
+        return;
+    }
+    if (group === "projects" && action === "edit" && resourceId) {
+        const name = optionValue(args, "--name");
+        const description = optionValue(args, "--description");
+        if (!name && !description) {
+            throw new Error("Informe pelo menos --name ou --description.");
+        }
+        const response = await request(`/api/v1/projects/${encodeURIComponent(resourceId)}`, {
+            method: "PATCH",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({
+                ...(name ? { name } : {}),
+                ...(description ? { description } : {}),
+            }),
+        });
+        console.log(`Projeto ${response.project.name} (${response.project.id}) atualizado: ${response.project.status}`);
+        return;
+    }
+    if (group === "projects" && action === "delete" && resourceId) {
+        requireConfirmation(args);
+        await request(`/api/v1/projects/${encodeURIComponent(resourceId)}`, {
+            method: "DELETE",
+        });
+        console.log(`Projeto ${resourceId} excluído.`);
+        return;
+    }
     if (group === "apps" && action === "list" && resourceId) {
         const { applications } = await request(`/api/v1/automation/projects/${encodeURIComponent(resourceId)}/apps`);
         printRows(applications.map((application) => ({
@@ -176,9 +262,146 @@ export async function main(args) {
         })));
         return;
     }
+    if (group === "templates" && action === "create" && resourceId && extra) {
+        return main([
+            "apps",
+            "create",
+            resourceId,
+            "--template",
+            extra,
+            ...args.slice(4),
+        ]);
+    }
+    if (group === "templates" && action === "services" && resourceId) {
+        const { services } = await request(`/api/v1/automation/projects/${encodeURIComponent(resourceId)}/templates`);
+        printRows(services.map((service) => ({
+            id: service.id,
+            name: service.name,
+            template: service.templateId,
+            version: service.templateVersion ?? "latest",
+            status: service.status,
+        })));
+        return;
+    }
+    if (group === "templates" && action === "deploy" && resourceId && extra) {
+        const response = await request(`/api/v1/projects/${encodeURIComponent(resourceId)}/templates/${encodeURIComponent(extra)}/deploy`, { method: "POST" });
+        if (response.deployment) {
+            console.log(`Deploy ${response.deployment.id} solicitado: ${response.deployment.status}`);
+        }
+        else {
+            console.log("Deploy solicitado. A execução ainda está sendo registrada pelo provider.");
+        }
+        return;
+    }
+    if (group === "templates" &&
+        action === "deployments" &&
+        resourceId &&
+        extra) {
+        const { deployments } = await request(`/api/v1/projects/${encodeURIComponent(resourceId)}/templates/${encodeURIComponent(extra)}/deployments`);
+        printRows(deployments.map((deployment) => ({
+            id: deployment.id,
+            status: deployment.status,
+            trigger: deployment.trigger,
+            created: deployment.createdAt,
+            title: deployment.title ?? "-",
+        })));
+        return;
+    }
+    if (group === "templates" &&
+        action === "status" &&
+        resourceId &&
+        extra &&
+        args[4]) {
+        const deploymentId = args[4];
+        const { deployments } = await request(`/api/v1/projects/${encodeURIComponent(resourceId)}/templates/${encodeURIComponent(extra)}/deployments`);
+        const deployment = deployments.find((candidate) => candidate.id === deploymentId);
+        if (!deployment) {
+            throw new Error("Deployment de template não encontrado para este serviço.");
+        }
+        printRows([
+            {
+                id: deployment.id,
+                status: deployment.status,
+                trigger: deployment.trigger,
+                created: deployment.createdAt,
+                title: deployment.title ?? "-",
+            },
+        ]);
+        return;
+    }
+    if (group === "templates" &&
+        action === "logs" &&
+        resourceId &&
+        extra &&
+        args[4]) {
+        const deploymentId = args[4];
+        const tail = args[5] ?? "200";
+        if (!/^\d+$/.test(tail))
+            throw new Error("tail deve ser numérico.");
+        const { logs } = await request(`/api/v1/projects/${encodeURIComponent(resourceId)}/templates/${encodeURIComponent(extra)}/deployments/${encodeURIComponent(deploymentId)}/logs?tail=${encodeURIComponent(tail)}`);
+        for (const log of logs)
+            console.log(`[${log.stream}] ${log.message}`);
+        return;
+    }
+    if (group === "templates" && action === "edit" && resourceId && extra) {
+        const envFile = requireOption(args, "--env-file");
+        const env = await readFile(envFile, "utf8");
+        await request(`/api/v1/projects/${encodeURIComponent(resourceId)}/templates/${encodeURIComponent(extra)}/env`, {
+            method: "PUT",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ env }),
+        });
+        console.log(`Variáveis do serviço ${extra} atualizadas.`);
+        return;
+    }
+    if (group === "templates" && action === "delete" && resourceId && extra) {
+        requireConfirmation(args);
+        await request(`/api/v1/projects/${encodeURIComponent(resourceId)}/templates/${encodeURIComponent(extra)}`, { method: "DELETE" });
+        console.log(`Serviço de template ${extra} excluído.`);
+        return;
+    }
     if (group === "apps" && action === "create" && resourceId) {
         const templateId = optionValue(args, "--template");
         const regionCode = optionValue(args, "--region");
+        if (!templateId && optionValue(args, "--source")) {
+            const name = requireOption(args, "--name");
+            const source = requireOption(args, "--source").toUpperCase();
+            const repositoryUrl = optionValue(args, "--repository");
+            const gitConnectionId = optionValue(args, "--git-connection");
+            if (!new Set(["GITHUB", "GIT", "DOCKER", "DOCKERFILE"]).has(source)) {
+                throw new Error("--source deve ser github, git, docker ou dockerfile.");
+            }
+            if (source === "GITHUB" && !gitConnectionId) {
+                throw new Error("Aplicações GitHub requerem --git-connection com uma conexão já cadastrada no painel.");
+            }
+            if (["GITHUB", "GIT", "DOCKERFILE"].includes(source) && !repositoryUrl) {
+                throw new Error("Informe --repository para esta origem.");
+            }
+            const repositoryBranch = optionValue(args, "--branch");
+            const buildType = optionValue(args, "--build-type");
+            const description = optionValue(args, "--description");
+            const runtimePort = integerOption(args, "--port");
+            const response = await request(`/api/v1/projects/${encodeURIComponent(resourceId)}/apps`, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    "idempotency-key": crypto.randomUUID(),
+                },
+                body: JSON.stringify({
+                    name,
+                    sourceType: source,
+                    ...(regionCode ? { regionCode } : {}),
+                    ...(repositoryUrl ? { repositoryUrl } : {}),
+                    ...(gitConnectionId ? { gitConnectionId } : {}),
+                    ...(repositoryBranch ? { repositoryBranch } : {}),
+                    ...(buildType ? { buildType: buildType.toUpperCase() } : {}),
+                    ...(description ? { description } : {}),
+                    ...(runtimePort ? { runtimePort } : {}),
+                }),
+            });
+            console.log(`Aplicação ${response.application.name} (${response.application.id}) criada: ${response.application.status}`);
+            return;
+        }
         if (!templateId) {
             throw new Error("Use --template <template-id>. Consulte os modelos com 'had templates list'.");
         }
@@ -194,6 +417,47 @@ export async function main(args) {
             }),
         });
         console.log(`Serviço ${response.service.name} (${response.service.id}) criado: ${response.service.status}`);
+        if (response.deployment) {
+            console.log(`Deployment do template: ${response.deployment.id} (${response.deployment.status})`);
+            console.log(`Status: had templates status ${resourceId} ${response.service.id} ${response.deployment.id}`);
+            console.log(`Logs: had templates logs ${resourceId} ${response.service.id} ${response.deployment.id}`);
+        }
+        else {
+            console.log(`O provider ainda está registrando a execução. Consulte com: had templates deployments ${resourceId} ${response.service.id}`);
+        }
+        return;
+    }
+    if (group === "apps" && action === "edit" && resourceId && extra) {
+        const name = optionValue(args, "--name");
+        const description = optionValue(args, "--description");
+        const repositoryBranch = optionValue(args, "--branch");
+        const buildType = optionValue(args, "--build-type");
+        const runtimePort = integerOption(args, "--port");
+        if (!name &&
+            !description &&
+            !repositoryBranch &&
+            !buildType &&
+            !runtimePort) {
+            throw new Error("Informe ao menos um campo para atualizar a aplicação.");
+        }
+        const response = await request(`/api/v1/projects/${encodeURIComponent(resourceId)}/apps/${encodeURIComponent(extra)}`, {
+            method: "PATCH",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({
+                ...(name ? { name } : {}),
+                ...(description ? { description } : {}),
+                ...(repositoryBranch ? { repositoryBranch } : {}),
+                ...(buildType ? { buildType: buildType.toUpperCase() } : {}),
+                ...(runtimePort ? { runtimePort } : {}),
+            }),
+        });
+        console.log(`Aplicação ${response.application.name} (${response.application.id}) atualizada.`);
+        return;
+    }
+    if (group === "apps" && action === "delete" && resourceId && extra) {
+        requireConfirmation(args);
+        await request(`/api/v1/projects/${encodeURIComponent(resourceId)}/apps/${encodeURIComponent(extra)}`, { method: "DELETE" });
+        console.log(`Aplicação ${extra} excluída.`);
         return;
     }
     if (group === "deploy" && action && resourceId && !extra) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hadcloud/deploy-cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": false,
   "type": "module",
   "bin": {