trello-cli-unofficial 0.15.1 → 0.17.0

package/CHANGELOG.md

@@ -1,3 +1,31 @@
+# [0.17.0](https://github.com/JaegerCaiser/trello-cli-unofficial/compare/v0.16.0...v0.17.0) (2026-04-10)
+
+
+### Bug Fixes
+
+* handle SIGINT in auth setup prompt with translated cancel message ([f352e4f](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/f352e4f5c4fe62b77573cbdb915cddbd4ae275cb))
+
+
+### Features
+
+* **search:** support advanced card search filters and pagination ([a5ebf31](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/a5ebf31c434b4168d9745be1a99331dd536704a8))
+
+# [0.16.0](https://github.com/JaegerCaiser/trello-cli-unofficial/compare/v0.15.1...v0.16.0) (2026-04-09)
+
+
+### Bug Fixes
+
+* bun version on runner ([503fc7a](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/503fc7a1c49957add117473a25f061450bdf1d61))
+* bun version on runner 2 ([d025133](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/d0251337bbbc6dbe0bfa0bd496dcaf07ca503736))
+* bun version on runner 3 ([ca5d4f7](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/ca5d4f730b42e4c9cd073968fff764f173430fbf))
+* bun version on runner 4 ([2b5f561](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/2b5f561ed028b5398655a8d6f7dc3d3d724f0d6c))
+* **tests:** add pt-BR language setup in GetBoardDetailsUseCase test ([0ad8441](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/0ad844153845297e34f391d9e5c3b59211d4f646))
+
+
+### Features
+
+* support Node production runtime and improve Trello auth ([283219f](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/283219f0171fb6e92748c51990f8d43bb12426e4))
+
 ## [0.15.1](https://github.com/JaegerCaiser/trello-cli-unofficial/compare/v0.15.0...v0.15.1) (2026-04-06)
 
 

package/README.md

@@ -1,5 +1,7 @@
 # Trello CLI Unofficial
 
+*Read this in other languages: [English](#-english) | [Português](#-português)*
+
 [![npm version](https://img.shields.io/npm/v/trello-cli-unofficial.svg)](https://www.npmjs.com/package/trello-cli-unofficial)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Bun](https://img.shields.io/badge/Bun-%23000000.svg?style=flat&logo=bun&logoColor=white)](https://bun.sh)
@@ -8,9 +10,93 @@
 [![CI/CD](https://img.shields.io/github/actions/workflow/status/JaegerCaiser/trello-cli-unofficial/ci.yml?branch=main&label=CI)](https://github.com/JaegerCaiser/trello-cli-unofficial/actions)
 [![Release](https://img.shields.io/github/actions/workflow/status/JaegerCaiser/trello-cli-unofficial/release.yml?branch=main&label=Release)](https://github.com/JaegerCaiser/trello-cli-unofficial/actions)
 
+---
+
+## 🇺🇸 English
+
+An unofficial Trello CLI with Power-Up authentication, built with Bun and TypeScript. It allows you to manage boards, lists, and cards with modern outputs and multi-profile support.
+
+### Quick Start
+
+```bash
+npm install -g trello-cli-unofficial
+```
+
+```bash
+tcu setup
+tcu interactive
+```
+
+### 🔑 Configuring the Trello Token
+
+On the first run, the CLI will ask for your Trello token (via Power-Up authentication). Follow these steps:
+
+**Step 1 — Access the Power-Ups admin dashboard:**
+Open in your browser: **https://trello.com/power-ups/admin**
+Log in to Trello if necessary.
+
+**Step 2 — Create a new Power-Up:**
+Click on **"New"** and fill in any name (e.g., `My CLI`). The name doesn't matter — it's just to identify the app in your account.
+> If you have created a Power-Up before, simply select it from the list.
+
+**Step 3 — Generate the token manually:**
+Inside your Power-Up's page, you will see a message on the right panel:
+> *"Most developers will need to ask each user to authorize their app. If you are building an app for yourself or doing local testing, you can manually generate a **token**."*
+
+Click on the highlighted word **token** in that message. A new page will open asking for confirmation — click **"Allow"**.
+
+**Step 4 — Copy the token:**
+The page will display a long sequence of characters starting with `ATTA`. Copy the entire string.
+
+**Step 5 — Paste it into the terminal:**
+When the CLI asks `Please enter your Trello token:`, paste the token and press Enter.
+
+> **Tip:** The token must always start with `ATTA`. If the CLI rejects your input, make sure you copied the full token without any extra spaces.
+
+> **Security:** The token is saved locally in `~/.trello-cli-unofficial/config.json`. To revoke access, go to [trello.com/account](https://trello.com/account) → **Power-Ups & Tokens** and revoke the token for this application.
+
+### Features
+
+- 🚀 Interactive mode with a guided menu
+- 📊 Output in JSON, table, and CSV formats
+- 🌍 i18n support (English / pt-BR)
+- 🔐 Power-Up authentication for Trello
+- 👤 Multi-profile support with persistent configuration
+
+### Commands
+
+```bash
+tcu boards
+
+tcu lists
+
+tcu cards
+
+tcu checklists
+
+tcu config
+```
+
+*To see all available parameters and options, run `tcu <command> --help` in your terminal.*
+
+### 📚 Full Documentation
+
+- [./docs/commands.md](./docs/commands.md)
+- [./docs/architecture.md](./docs/architecture.md)
+- [./docs/migration-guide.md](./docs/migration-guide.md)
+- [./docs/troubleshooting.md](./docs/troubleshooting.md)
+
+### Contributing
+
+Want to help improve the project? See our [Contributing Guide](CONTRIBUTING.md).
+
+---
+
+## 🇧🇷 Português
+
 Um CLI não-oficial para Trello com autenticação Power-Up, feito em Bun e TypeScript. Permite gerenciar boards, lists e cards com saídas modernas e suporte a múltiplos perfis.
 
-## Quick Start
+### Quick Start
 
 ```bash
 npm install -g trello-cli-unofficial
@@ -21,7 +107,35 @@ tcu setup
 tcu interactive
 ```
 
-## Features
+### 🔑 Configurando o Token do Trello
+
+Na primeira execução o CLI vai pedir seu token do Trello (autenticação via Power-Up). Siga os passos abaixo:
+
+**Passo 1 — Acesse o painel de administração de Power-Ups:**
+Abra no navegador: **https://trello.com/power-ups/admin**
+Faça login no Trello se necessário.
+
+**Passo 2 — Crie um novo Power-Up:**
+Clique em **"New"** e preencha com qualquer nome (ex: `Meu CLI`). O nome não importa — é só para identificar o app na sua conta.
+> Se você já criou um Power-Up antes, basta selecioná-lo na lista.
+
+**Passo 3 — Gere o token manualmente:**
+Dentro da página do seu Power-Up, você verá no painel à direita a mensagem:
+> *"A maioria dos desenvolvedores precisará solicitar a cada usuário que autorize seu aplicativo. Se você deseja criar um aplicativo para si mesmo ou está fazendo testes locais, é possível gerar um **token** manualmente."*
+
+Clique na palavra **token** destacada nessa mensagem. Uma nova página abrirá pedindo confirmação — clique em **"Permitir"**.
+
+**Passo 4 — Copie o token:**
+A página exibirá uma longa sequência de caracteres começando com `ATTA`. Copie tudo.
+
+**Passo 5 — Cole no terminal:**
+Quando o CLI perguntar `Por favor, insira seu token do Trello:`, cole o token e pressione Enter.
+
+> **Dica:** O token começa obrigatoriamente com `ATTA`. Se o CLI rejeitar sua entrada, verifique se copiou o token completo sem espaços extras.
+
+> **Segurança:** O token fica salvo localmente em `~/.trello-cli-unofficial/config.json`. Para revogar o acesso, acesse [trello.com/account](https://trello.com/account) → **Power-Ups & Tokens** e revogue o token desta aplicação.
+
+### Features
 
 - 🚀 Modo interativo com menu guiado
 - 📊 Saída em JSON, table e CSV
@@ -29,7 +143,7 @@ tcu interactive
 - 🔐 Autenticação Power-Up para Trello
 - 👤 Suporte a múltiplos perfis e configuração persistente
 
-## Commands
+### Commands
 
 ```bash
 tcu boards
@@ -38,18 +152,20 @@ tcu lists
 
 tcu cards
 
+tcu checklists
+
 tcu config
 ```
 
 *Para ver todos os parâmetros e opções, execute `tcu <comando> --help` no seu terminal.*
 
-## 📚 Documentação Completa
+### 📚 Documentação Completa
 
 - [./docs/commands.md](./docs/commands.md)
 - [./docs/architecture.md](./docs/architecture.md)
 - [./docs/migration-guide.md](./docs/migration-guide.md)
 - [./docs/troubleshooting.md](./docs/troubleshooting.md)
 
-## Contribuição
+### Contribuição
 
-Quer ajudar a melhorar o projeto? Veja nosso [Guia de Contribuição](CONTRIBUTING.md).
+Quer ajudar a melhorar o projeto? Veja nosso [Guia de Contribuição](CONTRIBUTING.md).

package/bin/cli.js

@@ -1,126 +1,34 @@
 #!/usr/bin/env node
-
-import { execSync, spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
 import path from 'node:path';
 import process from 'node:process';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-// Detect language from environment
-function detectLanguage() {
-  const langVars = ['LANG', 'LANGUAGE', 'LC_ALL', 'LC_MESSAGES'];
-  for (const varName of langVars) {
-    const value = process.env[varName];
-    if (value && value.toLowerCase().includes('pt')) {
-      return 'pt';
-    }
-  }
-  return 'en';
-}
-
-const lang = detectLanguage();
-
-const messages = {
-  pt: {
-    bunRequired: '❌ Bun é necessário para executar o Trello CLI Unofficial',
-    bunNotFound: 'Bun não foi encontrado no sistema',
-    installBun: '📦 Instale o Bun primeiro:',
-    installCommand: 'curl -fsSL https://bun.sh/install | bash',
-    windowsInstall: 'powershell -c "irm bun.sh/install.ps1 | iex"',
-    afterInstall: 'Após instalar, reinicie o terminal e execute novamente',
-    versionCommand: 'Verifique com: bun --version',
-  },
-  en: {
-    bunRequired: '❌ Bun is required to run Trello CLI Unofficial',
-    bunNotFound: 'Bun was not found on the system',
-    installBun: '📦 Please install Bun first:',
-    installCommand: 'curl -fsSL https://bun.sh/install | bash',
-    windowsInstall: 'powershell -c "irm bun.sh/install.ps1 | iex"',
-    afterInstall: 'After installation, restart your terminal and run again',
-    versionCommand: 'Check with: bun --version',
-  },
-};
-
-const msg = messages[lang];
-
-// Check if Bun is available (local or global)
-function isBunAvailable() {
-  try {
-    // First try local Bun
-    execSync('node_modules/.bin/bun --version', { stdio: 'pipe' });
-    return 'local';
-  }
-  catch {
-    try {
-      // Then try global Bun
-      execSync('bun --version', { stdio: 'pipe' });
-      return 'global';
-    }
-    catch {
-      return false;
-    }
-  }
-}
-
-// Main execution
-const bunType = isBunAvailable();
-if (!bunType) {
-  console.log(msg.bunRequired);
-  console.log(msg.bunNotFound);
-  console.log('');
-  console.log(msg.installBun);
-
-  // Detect platform for appropriate install command
-  const platform = process.platform;
-  if (platform === 'win32') {
-    console.log(`Windows: ${msg.windowsInstall}`);
-  }
-  else {
-    console.log(`Unix/Linux/macOS: ${msg.installCommand}`);
-  }
-
-  console.log('');
-  console.log(msg.afterInstall);
-  console.log(msg.versionCommand);
-  process.exit(1);
-}
-
-// Bun is available, execute the main script
 const mainScript = path.join(__dirname, '..', 'dist', 'main.js');
-const args = process.argv.slice(2);
 
-// Check for verbose flag
-const isVerbose = args.includes('--verbose') || args.includes('-V');
-if (isVerbose) {
-  process.env.VERBOSE_ERRORS = 'true';
-  // Remove verbose flag from args so it doesn't interfere
-  const verboseIndex = args.indexOf('--verbose');
-  if (verboseIndex !== -1) {
-    args.splice(verboseIndex, 1);
-  }
-  const shortVerboseIndex = args.indexOf('-V');
-  if (shortVerboseIndex !== -1) {
-    args.splice(shortVerboseIndex, 1);
-  }
+if (!existsSync(mainScript)) {
+  const lang = ['LANG', 'LANGUAGE', 'LC_ALL', 'LC_MESSAGES']
+    .map(v => process.env[v] || '')
+    .some(v => v.toLowerCase().includes('pt'))
+    ? 'pt'
+    : 'en';
+
+  const messages = {
+    pt: [
+      '❌ Build não encontrado. O pacote pode ter sido corrompido.',
+      '   Tente reinstalar: npm install -g trello-cli-unofficial',
+      '   Ou, se for desenvolvedor: bun run build',
+    ],
+    en: [
+      '❌ Build not found. The package may be corrupted.',
+      '   Try reinstalling: npm install -g trello-cli-unofficial',
+      '   Or, if you are a developer: bun run build',
+    ],
+  };
+
+  console.error(messages[lang].join('\n'));
+  process.exit(1);
 }
 
-// Use local Bun if available, otherwise global
-const bunCommand = bunType === 'local'
-  ? path.join(__dirname, '..', 'node_modules', '.bin', 'bun')
-  : 'bun';
-
-const child = spawn(bunCommand, [mainScript, ...args], {
-  stdio: 'inherit',
-  cwd: process.cwd(),
-  env: { ...process.env, VERBOSE_ERRORS: process.env.VERBOSE_ERRORS || 'false' },
-});
-
-child.on('exit', (code) => {
-  process.exit(code);
-});
-
-child.on('error', (error) => {
-  console.error('Failed to start Bun:', error.message);
-  process.exit(1);
-});
+await import(pathToFileURL(mainScript).href);