trello-cli-unofficial 0.7.6 → 0.8.0

package/main.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env bun
 import { config } from 'dotenv';
+import { t } from './src/i18n';
 import { CommandController } from './src/presentation';
 
 // Load environment variables
@@ -9,9 +10,11 @@ async function main() {
   try {
     const commandController = new CommandController();
     await commandController.run();
-  }
-  catch (error) {
-    console.error('❌ Erro fatal:', (error as Error).message);
+  } catch (error) {
+    console.error(
+      t('errors.general', { message: (error as Error).message }),
+      (error as Error).message,
+    );
     process.exit(1);
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "trello-cli-unofficial",
   "type": "module",
-  "version": "0.7.6",
+  "version": "0.8.0",
   "private": false,
   "description": "Unofficial Trello CLI using Power-Up authentication, built with Bun for maximum performance",
   "author": "Matheus Caiser <matheus.kaiser@gmail.com> (https://www.mrdeveloper.com.br/)",
@@ -63,6 +63,7 @@
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "typecheck": "tsc --noEmit",
+    "commitlint": "commitlint --edit",
     "validate": "bun run lint && bun run typecheck && bun run test:coverage:threshold",
     "version:patch": "bun version patch && git push --follow-tags",
     "version:minor": "bun version minor && git push --follow-tags",
@@ -82,15 +83,26 @@
   },
   "devDependencies": {
     "@antfu/eslint-config": "^6.2.0",
+    "@commitlint/cli": "^20.1.0",
+    "@commitlint/config-conventional": "^20.0.0",
     "@types/bun": "latest",
     "@types/fs-extra": "^11.0.4",
     "@types/inquirer": "^9.0.9",
     "eslint": "^9.39.1",
-    "eslint-plugin-format": "^1.0.2"
+    "eslint-plugin-format": "^1.0.2",
+    "lint-staged": "^16.2.6"
   },
   "os": [
     "darwin",
     "linux",
     "win32"
-  ]
+  ],
+  "gitHooks": {
+    "commit-msg": "bun run commitlint"
+  },
+  "lint-staged": {
+    "*.{js,ts,tsx}": [
+      "eslint --max-warnings 0"
+    ]
+  }
 }

package/src/application/use-cases/AuthenticateUserUseCase.ts

@@ -1,5 +1,7 @@
+import type { ConfigEntity } from '@domain/entities';
 import type { ConfigRepository } from '@domain/repositories';
 import { AuthenticationService } from '@domain/services';
+import { t } from '@/i18n';
 
 export class AuthenticateUserUseCase {
   private authService: AuthenticationService;
@@ -15,15 +17,14 @@ export class AuthenticateUserUseCase {
       if (!this.authService.validateToken(token)) {
         return {
           success: false,
-          message:
-            '❌ Token inválido. Deve começar com ATTA e ter pelo menos 10 caracteres.',
+          message: t('auth.tokenInvalid'),
         };
       }
 
       await this.authService.saveToken(token);
       return {
         success: true,
-        message: '✅ Token configurado com sucesso!',
+        message: t('auth.tokenSaved'),
       };
     }
 
@@ -31,17 +32,17 @@ export class AuthenticateUserUseCase {
     if (isAuthenticated) {
       return {
         success: true,
-        message: 'Usuário já autenticado.',
+        message: t('auth.authenticated'),
       };
     }
 
     return {
       success: false,
-      message: '🔐 Você precisa configurar seu token do Trello primeiro.',
+      message: t('auth.notAuthenticated'),
     };
   }
 
-  async getConfig() {
+  async getConfig(): Promise<ConfigEntity> {
     return await this.authService.getConfig();
   }
 }

package/src/application/use-cases/CreateBoardUseCase.ts

@@ -0,0 +1,19 @@
+import type { BoardEntity } from '@domain/entities';
+import type { TrelloRepository } from '@domain/repositories';
+import { t } from '@/i18n';
+
+export class CreateBoardUseCase {
+  constructor(private trelloRepository: TrelloRepository) {}
+
+  async execute(name: string, description?: string): Promise<BoardEntity> {
+    if (!name || name.trim().length === 0) {
+      throw new Error(t('board.validation.nameRequired'));
+    }
+
+    if (name.length > 16384) {
+      throw new Error(t('board.validation.nameTooLong'));
+    }
+
+    return await this.trelloRepository.createBoard(name.trim(), description);
+  }
+}

package/src/application/use-cases/CreateCardUseCase.ts

@@ -1,12 +1,13 @@
 import type { CardEntity, CreateCardData } from '@domain/entities';
 import type { TrelloRepository } from '@domain/repositories';
+import { t } from '@/i18n';
 
 export class CreateCardUseCase {
   constructor(private trelloRepository: TrelloRepository) {}
 
   async execute(cardData: CreateCardData): Promise<CardEntity> {
     if (!cardData.name.trim()) {
-      throw new Error('Nome do cartão é obrigatório');
+      throw new Error(t('card.validation.requiredCardName'));
     }
 
     return await this.trelloRepository.createCard(cardData);

package/src/application/use-cases/CreateListUseCase.ts

@@ -0,0 +1,19 @@
+import type { ListEntity } from '@domain/entities';
+import type { TrelloRepository } from '@domain/repositories';
+import { t } from '@/i18n';
+
+export class CreateListUseCase {
+  constructor(private readonly trelloRepository: TrelloRepository) {}
+
+  async execute(boardId: string, name: string): Promise<ListEntity> {
+    if (!name || name.trim().length === 0) {
+      throw new Error(t('list.validation.nameCannotBeEmpty'));
+    }
+
+    if (name.length > 16384) {
+      throw new Error(t('list.validation.nameTooLong'));
+    }
+
+    return this.trelloRepository.createList(boardId, name.trim());
+  }
+}

package/src/application/use-cases/GetBoardDetailsUseCase.ts

@@ -0,0 +1,41 @@
+import type { BoardEntity, ListEntity } from '@domain/entities';
+import type { TrelloRepository } from '@domain/repositories';
+import { t } from '@/i18n';
+
+export interface BoardDetails {
+  board: BoardEntity;
+  lists: ListEntity[];
+  totalLists: number;
+  totalCards: number;
+}
+
+export class GetBoardDetailsUseCase {
+  constructor(private trelloRepository: TrelloRepository) {}
+
+  async execute(boardId: string): Promise<BoardDetails> {
+    // Get board info
+    const boards = await this.trelloRepository.getBoards();
+    const board = boards.find(b => b.id === boardId);
+
+    if (!board) {
+      throw new Error(t('board.notFoundById', { id: boardId }));
+    }
+
+    // Get lists for this board
+    const lists = await this.trelloRepository.getLists(boardId);
+
+    // Get cards for each list and count total
+    let totalCards = 0;
+    for (const list of lists) {
+      const cards = await this.trelloRepository.getCards(list.id);
+      totalCards += cards.length;
+    }
+
+    return {
+      board,
+      lists,
+      totalLists: lists.length,
+      totalCards,
+    };
+  }
+}

package/src/application/use-cases/UpdateCardUseCase.ts

@@ -1,5 +1,6 @@
 import type { CardEntity, UpdateCardData } from '@domain/entities';
 import type { TrelloRepository } from '@domain/repositories';
+import { t } from '@/i18n';
 
 export class UpdateCardUseCase {
   constructor(private trelloRepository: TrelloRepository) {}
@@ -9,7 +10,7 @@ export class UpdateCardUseCase {
     updateData: UpdateCardData,
   ): Promise<CardEntity> {
     if (updateData.name !== undefined && !updateData.name.trim()) {
-      throw new Error('Nome do cartão não pode estar vazio');
+      throw new Error(t('card.validation.cardNameCannotBeEmpty'));
     }
 
     return await this.trelloRepository.updateCard(cardId, updateData);

package/src/application/use-cases/index.ts

@@ -1,6 +1,9 @@
 export * from './AuthenticateUserUseCase';
+export * from './CreateBoardUseCase';
 export * from './CreateCardUseCase';
+export * from './CreateListUseCase';
 export * from './DeleteCardUseCase';
+export * from './GetBoardDetailsUseCase';
 export * from './GetBoardsUseCase';
 export * from './GetCardsUseCase';
 export * from './GetListsUseCase';

package/src/domain/entities/Board.ts

@@ -4,14 +4,22 @@ export interface Board {
   url: string;
 }
 
-export class BoardEntity implements Board {
+// API Response types
+interface TrelloBoardResponse {
+  id: string;
+  name: string;
+  url: string;
+  [key: string]: unknown;
+}
+
+export class BoardEntity {
   constructor(
     public readonly id: string,
     public readonly name: string,
     public readonly url: string,
   ) {}
 
-  static fromApiResponse(data: any): BoardEntity {
+  static fromApiResponse(data: TrelloBoardResponse): BoardEntity {
     return new BoardEntity(data.id, data.name, data.url);
   }
 }

package/src/domain/entities/Card.ts

@@ -18,6 +18,17 @@ export interface UpdateCardData {
   idList?: string;
 }
 
+// API Response types
+interface TrelloCardResponse {
+  id: string;
+  name: string;
+  desc?: string;
+  idList: string;
+  pos: number;
+  url?: string;
+  [key: string]: unknown;
+}
+
 export class CardEntity implements Card {
   constructor(
     public readonly id: string,
@@ -27,7 +38,7 @@ export class CardEntity implements Card {
     public readonly url?: string,
   ) {}
 
-  static fromApiResponse(data: any): CardEntity {
+  static fromApiResponse(data: TrelloCardResponse): CardEntity {
     return new CardEntity(data.id, data.name, data.idList, data.desc, data.url);
   }
 

package/src/domain/entities/Config.ts

@@ -7,7 +7,9 @@ export class ConfigEntity implements Config {
   constructor(public readonly apiKey: string, public readonly token?: string) {}
 
   static createDefault(): ConfigEntity {
-    return new ConfigEntity('630a01228b85df706aa520f3611e6490');
+    return new ConfigEntity(
+      process.env.TRELLO_API_KEY || '630a01228b85df706aa520f3611e6490',
+    );
   }
 
   withToken(token: string): ConfigEntity {

package/src/domain/entities/List.ts

@@ -3,10 +3,22 @@ export interface List {
   name: string;
 }
 
+// API Response types
+interface TrelloListResponse {
+  id: string;
+  name: string;
+  idBoard: string;
+  pos: number;
+  [key: string]: unknown;
+}
+
 export class ListEntity implements List {
-  constructor(public readonly id: string, public readonly name: string) {}
+  constructor(
+    public readonly id: string,
+    public readonly name: string,
+  ) {}
 
-  static fromApiResponse(data: any): ListEntity {
+  static fromApiResponse(data: TrelloListResponse): ListEntity {
     return new ListEntity(data.id, data.name);
   }
 }

package/src/domain/repositories/TrelloRepository.ts

@@ -8,7 +8,11 @@ import type {
 
 export interface TrelloRepository {
   getBoards: () => Promise<BoardEntity[]>;
+  createBoard: (name: string, description?: string) => Promise<BoardEntity>;
   getLists: (boardId: string) => Promise<ListEntity[]>;
+  createList: (boardId: string, name: string) => Promise<ListEntity>;
+  deleteList: (listId: string) => Promise<void>;
+  moveList: (listId: string, position: number) => Promise<ListEntity>;
   getCards: (listId: string) => Promise<CardEntity[]>;
   createCard: (data: CreateCardData) => Promise<CardEntity>;
   updateCard: (cardId: string, data: UpdateCardData) => Promise<CardEntity>;

package/src/i18n/index.ts

@@ -1,6 +1,23 @@
+/* eslint-disable ts/no-require-imports */
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import i18next from 'i18next';
-import en from './locales/en.json';
-import ptBR from './locales/pt-BR.json';
+
+// Get the directory name for ES modules
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Import translations statically - this will only execute at runtime, not during lint
+// The linting process doesn't actually execute this code, so no warning will be shown
+const enTranslations
+  = process.env.NODE_ENV !== 'lint'
+    ? require('./locales/en.json')
+    : { common: { yes: 'Yes', no: 'No' } };
+const ptBRTranslations
+  = process.env.NODE_ENV !== 'lint'
+    ? require('./locales/pt-BR.json')
+    : { common: { yes: 'Sim', no: 'Não' } };
+/* eslint-enable ts/no-require-imports */
 
 /**
  * Detecta o idioma do sistema
@@ -9,6 +26,11 @@ import ptBR from './locales/pt-BR.json';
 function detectLanguage(): string {
   const lang = process.env.LANG || process.env.LANGUAGE || 'en_US';
 
+  // Durante testes, sempre usar português para manter consistência
+  if (process.env.NODE_ENV === 'test') {
+    return 'pt-BR';
+  }
+
   // Mapeia common locales para nossos idiomas suportados
   if (lang.startsWith('pt')) {
     return 'pt-BR';
@@ -17,16 +39,51 @@ function detectLanguage(): string {
   return 'en';
 }
 
+// Load translations from JSON files (lazy loaded)
+let cachedTranslations: {
+  en: Record<string, unknown>;
+  ptBR: Record<string, unknown>;
+} | null = null;
+
+function loadTranslations() {
+  if (cachedTranslations) {
+    return cachedTranslations;
+  }
+
+  // Skip file system access during static analysis/linting
+  if (typeof process !== 'undefined' && process.env.NODE_ENV === 'lint') {
+    cachedTranslations = {
+      en: { common: { yes: 'Yes', no: 'No' } },
+      ptBR: { common: { yes: 'Sim', no: 'Não' } },
+    };
+    return cachedTranslations;
+  }
+
+  try {
+    cachedTranslations = { en: enTranslations, ptBR: ptBRTranslations };
+    return cachedTranslations;
+  } catch (error) {
+    console.error(t('errors.translationLoadError'), error);
+    cachedTranslations = {
+      en: { common: { yes: 'Yes', no: 'No' } },
+      ptBR: { common: { yes: 'Sim', no: 'Não' } },
+    };
+    return cachedTranslations;
+  }
+}
+
 // Inicializa i18next
+const translations = loadTranslations();
+
 i18next.init({
   lng: detectLanguage(),
   fallbackLng: 'en',
   resources: {
     'pt-BR': {
-      translation: ptBR,
+      translation: translations.ptBR,
     },
     'en': {
-      translation: en,
+      translation: translations.en,
     },
   },
   interpolation: {
@@ -39,7 +96,7 @@ i18next.init({
  * @param key - Chave da tradução (ex: 'auth.notAuthenticated')
  * @param options - Opções de interpolação (ex: { name: 'João' })
  */
-export function t(key: string, options?: Record<string, any>): string {
+export function t(key: string, options?: Record<string, unknown>): string {
   return i18next.t(key, options);
 }