CLI

@millionsend/cli move uma conta de e-mail para o MillionSend — Cloud ou sua própria instância. Ele lê o provedor de origem, compara com o destino, aplica a diferença e grava um relatório. Hoje a única origem é o Resend.

Instalação

Node 18 ou mais novo, sem dependências. Rode sem instalar:

npx @millionsend/cli migrate --from resend

Ou instale uma vez:

npm install -g @millionsend/cli
millionsend --version

Comandos

millionsend migrate --from resend                          # conectar, escolher recursos, planejar, confirmar, aplicar, resumo
millionsend migrate plan --from resend [--out plan.json]   # somente leitura; saída 0 nada a fazer, 2 há mudanças, 1 erro
millionsend migrate apply [plan.json] [--yes]              # aplica um plano salvo, ou planeja e aplica de uma vez
millionsend migrate status                                 # o que a última execução criou e o que falta
millionsend migrate rollback [--yes]                       # exclui apenas o que esta ferramenta criou
millionsend --help | --version

• migrate é o caminho interativo: pergunta o que falta (chaves, URL de destino), deixa você escolher recursos numa lista de caixas de seleção (todas marcadas por padrão, exceto broadcasts enviados), mostra o plano, pede confirmação, aplica e imprime o resumo.
• migrate plan lê os dois lados e imprime o que mudaria sem gravar nada no destino. --out plan.json salva. Antes de qualquer escrita, o plano consulta o GET /usage do destino — plano, limites, flag de cloud — e diz precisamente o que não cabe ("7 domínios a criar; o plano Free permite 3"), mais uma estimativa: "~2.140 requisições · cerca de 4 min a 8 req/s".
• migrate apply aplica um plano salvo, ou planeja e aplica de uma vez. Conflitos são resolvidos do mesmo jeito em toda execução: contatos passam por upsert pelo e-mail; tópicos, segmentos, propriedades, webhooks, templates e domínios são casados por nome, chave, endpoint ou alias e atualizados quando seus campos diferem, deixados como estão quando são iguais.
• migrate status imprime o que a última execução criou e o que falta no checklist. Não precisa de credenciais.
• migrate rollback exclui apenas os ids que a ferramenta criou — nunca linhas que ela só atualizou — em ordem inversa de dependência, depois de imprimir a lista e pedir confirmação (--yes pula). Excluir contatos é uma requisição por contato; o prompt mostra a estimativa de tempo.

Flags

Nomes de recurso para --only e --skip, na ordem de aplicação: domains, properties, topics, segments, contacts, broadcasts, templates, webhooks, suppressions, enrichment, api-keys.

Ambiente

Cada chave é resolvida nesta ordem: variável de ambiente, depois a flag -stdin, depois a flag de argumento, depois — num terminal — um prompt mascarado. A URL de destino vem de MILLIONSEND_BASE_URL ou --to-url; sem nenhuma das duas, um terminal oferece a escolha entre o MillionSend Cloud e uma URL auto-hospedada, e uma execução não interativa mira o MillionSend Cloud, como nos SDKs.

Arquivos

Gravados ao lado de onde você roda a ferramenta, modo 0600, nunca contendo uma chave:

.millionsend/ é acrescentado ao .gitignore quando existe um no diretório atual; a ferramenta avisa uma vez.

Modelo de segurança

• Somente leitura na origem. Toda requisição ao Resend é um GET a um endpoint documentado, enviada com o User-Agent millionsend-cli/<versão>. Escritas vão apenas para a sua API do MillionSend.
• As chaves ficam em memória. Nunca são gravadas em arquivo e são redigidas de toda linha de log (re_…, ms_…, whsec_… e headers Authorization).
• Dois hosts, nenhum terceiro. A ferramenta contata api.resend.com e a URL da API do MillionSend que você informou. Sem telemetria, sem verificação de atualização.
• 401 ou 403 de qualquer lado interrompe a execução. Sem retentativa, sem contorno.
• Limites de taxa são respeitados. 429 aguarda o retry-after; 5xx e erros de rede recuam exponencialmente, 5 tentativas. Cada retentativa é registrada.
• Descadastros são preservados. unsubscribed e opt-outs de tópico vêm como estão; a ferramenta nunca reinscreve ninguém. Supressões mantêm a origem (bounce, reclamação, manual).

Códigos de saída

Não interativo e CI

Quando o stdin não é um terminal — ou com --non-interactive ou --json — a ferramenta nunca pergunta: uma entrada faltante sai com 1 e diz qual variável de ambiente ou flag definir. Passe chaves pelo ambiente ou pelo stdin, nunca como argumentos:

export RESEND_API_KEY=re_...
export MILLIONSEND_API_KEY=ms_...
export MILLIONSEND_BASE_URL=https://api.millionsend.com   # ou a URL da sua instância

millionsend migrate plan --from resend --out plan.json
# saída 2 quando há algo a aplicar
millionsend migrate apply plan.json --yes

Ou pelo stdin, primeira linha origem, segunda linha destino:

printf '%s\n%s\n' "$RESEND_KEY" "$MS_KEY" | millionsend migrate plan --from resend --from-key-stdin --to-key-stdin --to-url https://api.sua-instancia

O progresso é impresso uma linha por passo (✓, ✗, ⟳ com contadores n/N), acrescentado quando encadeado por pipe, reescrito no lugar num terminal.

--json

Com --json, o stdout carrega apenas JSON — o plano em migrate plan, o relatório em migrate apply — e o progresso vai para o stderr, então a saída pode ser encadeada no jq ou salva como artefato. --json implica --non-interactive.

millionsend migrate plan --from resend --json | jq '.counts'

Resend é uma marca registrada da Plus Five Five, Inc. O MillionSend não é afiliado nem endossado pelo Resend.