trello-cli-unofficial 0.10.2 → 0.10.3

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [0.10.3](https://github.com/JaegerCaiser/trello-cli-unofficial/compare/v0.10.2...v0.10.3) (2025-11-14)
+
+
+### Bug Fixes
+
+* add Windows USERPROFILE support for config directory ([36f72ca](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/36f72ca4685236e5bb2f03a5966e81b14815ad9c))
+
 ## [0.10.2](https://github.com/JaegerCaiser/trello-cli-unofficial/compare/v0.10.1...v0.10.2) (2025-11-14)
 
 

package/README.md

@@ -350,6 +350,119 @@ bun run typecheck
 bun run lint
 ```
 
+## 🧪 Cross-Platform Development Testing
+
+This project includes tools for testing cross-platform compatibility during development:
+
+### Quick Cross-Platform Test
+
+```bash
+# Run comprehensive cross-platform tests
+bun run test:cross-platform
+
+# This will test:
+# ✅ Build process
+# ✅ Installation process
+# ✅ CLI functionality (--version, --help)
+# ✅ File system operations
+# ✅ Environment variable handling
+# ✅ Platform-specific features
+```
+
+### Individual Test Commands
+
+```bash
+# Test build process only
+bun run test:build
+
+# Test installation process
+bun run test:install
+
+# Quick smoke tests
+bun run test:smoke
+```
+
+### Docker-Based Cross-Platform Testing
+
+For comprehensive testing across platforms, use Docker containers:
+
+```bash
+# Test on all platforms (Linux + Windows when available)
+npm run test:docker
+
+# Test specific platforms
+npm run test:docker:ubuntu    # Ubuntu Linux
+npm run test:docker:alpine    # Alpine Linux
+npm run test:docker:windows   # Windows (requires Windows host or WSL2)
+```
+
+**Platform Support:**
+- ✅ **Linux**: Ubuntu 22.04, Ubuntu 20.04, Alpine Linux
+- ✅ **Windows**: Windows Server Core 2022 (via Docker Desktop)
+- ✅ **macOS**: Tested via GitHub Actions CI/CD
+
+**Requirements:**
+- Docker Desktop installed
+- 4GB+ RAM allocated to Docker
+- For Windows containers: Windows 10/11 Pro+ or WSL2
+
+See [`WINDOWS_TESTING.md`](./WINDOWS_TESTING.md) for detailed Windows setup instructions.
+
+### Manual Windows Testing Checklist
+
+When testing on Windows, verify these scenarios:
+
+1. **Installation Methods:**
+   ```powershell
+   # Method 1: NPM global install
+   npm install -g trello-cli-unofficial
+
+   # Method 2: From source
+   bun install
+   bun link  # or bun run install-global
+   ```
+
+2. **Command Availability:**
+   ```powershell
+   # Test both command names
+   tcu --version
+   trello-cli-unofficial --version
+
+   # Test in different terminals
+   # - Command Prompt (cmd)
+   # - PowerShell
+   # - Windows Terminal
+   ```
+
+3. **PATH Configuration:**
+   ```powershell
+   # Check if commands are in PATH
+   where tcu
+   where trello-cli-unofficial
+
+   # Refresh environment (PowerShell)
+   $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
+   ```
+
+4. **File System Operations:**
+   - Config directory creation: `%USERPROFILE%\.trello-cli-unofficial\`
+   - File read/write permissions
+   - Path separator handling (`\` vs `/`)
+
+5. **Environment Variables:**
+   - `TRELLO_TOKEN` handling
+   - Language detection (`LANG`, `LC_ALL`, etc.)
+   - Node.js/Bun path resolution
+
+### Common Windows Issues & Solutions
+
+| Issue | Symptom | Solution |
+|-------|---------|----------|
+| PATH not updated | `tcu command not found` | Restart terminal or run `refreshenv` |
+| Permission denied | Installation fails | Run as Administrator |
+| Antivirus blocking | Installation interrupted | Temporarily disable or whitelist |
+| Node version conflicts | Runtime errors | Use Node 18+ or Bun 1.0+ |
+
 ## 🔒 Security
 
 - Token saved locally in protected file (`~/.trello-cli-unofficial/config.json`)
@@ -441,6 +554,8 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
+---
+
 **Note**: This is an unofficial project and is not affiliated with Atlassian or Trello.
 
 ---

package/dist/main.js

@@ -28638,7 +28638,8 @@ class FileConfigRepository {
   configDir;
   configFile;
   constructor() {
-    this.configDir = path3.join(process.env.HOME || "~", ".trello-cli-unofficial");
+    const homeDir = process.env.HOME || process.env.USERPROFILE || "~";
+    this.configDir = path3.join(homeDir, ".trello-cli-unofficial");
     this.configFile = path3.join(this.configDir, "config.json");
   }
   async load() {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "trello-cli-unofficial",
   "type": "module",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "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/)",
@@ -61,6 +61,15 @@
     "test:integration": "bun test tests/integration",
     "test:coverage": "bun test --coverage",
     "test:coverage:threshold": "bun test --coverage --coverage-reporter=lcov && bun run scripts/check-coverage.js",
+    "test:cross-platform": "node scripts/test-cross-platform.js",
+    "test:build": "bun run build && echo '✅ Build successful'",
+    "test:install": "bun run build && npm pack && npm install -g *.tgz && tcu --version && echo '✅ Installation successful'",
+    "test:smoke": "bun run test:install && tcu --help > /dev/null && echo '✅ Smoke tests passed'",
+    "test:docker": "./docker/test-all.sh",
+    "test:docker:ubuntu": "./docker/test-ubuntu.sh",
+    "test:docker:alpine": "./docker/test-alpine.sh",
+    "test:docker:windows": "./docker/test-windows.sh",
+    "test:docker:node": "./docker/test-node-versions.sh",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "lint:json": "node -e \"JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8')); console.log('JSON is valid')\" --",

package/scripts/test-cross-platform.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+
+/**
+ * Cross-Platform Testing Script
+ *
+ * This script helps identify potential cross-platform compatibility issues
+ * by simulating different environments and testing edge cases.
+ */
+
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import process from 'node:process';
+
+console.log('🧪 Cross-Platform Compatibility Tests\n');
+
+// Test 1: Build verification
+console.log('1️⃣ Testing build process...');
+try {
+  execSync('bun run build', { stdio: 'inherit' });
+  console.log('✅ Build successful\n');
+}
+catch (error) {
+  console.error('❌ Build failed:', error.message);
+  process.exit(1);
+}
+
+// Test 2: Installation simulation
+console.log('2️⃣ Testing installation process...');
+try {
+  execSync('npm pack', { stdio: 'inherit' });
+  execSync('npm install -g *.tgz', { stdio: 'inherit' });
+  console.log('✅ Installation successful\n');
+}
+catch (error) {
+  console.error('❌ Installation failed:', error.message);
+  process.exit(1);
+}
+
+// Test 3: CLI functionality
+console.log('3️⃣ Testing CLI functionality...');
+try {
+  const version = execSync('tcu --version', { encoding: 'utf8' }).trim();
+  console.log(`✅ Version command works: ${version}`);
+
+  execSync('tcu --help > /dev/null', { stdio: 'inherit' });
+  console.log('✅ Help command works\n');
+}
+catch (error) {
+  console.error('❌ CLI functionality failed:', error.message);
+  process.exit(1);
+}
+
+// Test 4: Path handling (Windows vs Unix)
+console.log('4️⃣ Testing path handling...');
+try {
+  const configDir = path.join(os.homedir(), '.trello-cli-unofficial');
+  console.log(`Config directory: ${configDir}`);
+
+  // Test if we can create the config directory
+  if (!fs.existsSync(configDir)) {
+    fs.mkdirSync(configDir, { recursive: true });
+    console.log('✅ Config directory creation works');
+  }
+  else {
+    console.log('✅ Config directory exists');
+  }
+
+  // Test file operations
+  const testFile = path.join(configDir, 'test-config.json');
+  fs.writeFileSync(testFile, JSON.stringify({ test: true }, null, 2));
+  fs.unlinkSync(testFile);
+
+  console.log('✅ File operations work\n');
+}
+catch (error) {
+  console.error('❌ Path handling failed:', error.message);
+  process.exit(1);
+}
+
+// Test 5: Environment variables
+console.log('5️⃣ Testing environment variables...');
+try {
+  // Test LANG detection
+  const langVars = ['LANG', 'LANGUAGE', 'LC_ALL', 'LC_MESSAGES'];
+  let detectedLang = 'en';
+
+  for (const varName of langVars) {
+    const value = process.env[varName];
+    if (value && value.toLowerCase().includes('pt')) {
+      detectedLang = 'pt';
+      break;
+    }
+  }
+
+  console.log(`✅ Language detection works: ${detectedLang}`);
+
+  // Test TRELLO_TOKEN handling
+  const token = process.env.TRELLO_TOKEN;
+  if (token) {
+    console.log('✅ TRELLO_TOKEN environment variable detected');
+  }
+  else {
+    console.log('ℹ️  No TRELLO_TOKEN environment variable (expected)');
+  }
+  console.log('');
+}
+catch (error) {
+  console.error('❌ Environment variable testing failed:', error.message);
+  process.exit(1);
+}
+
+// Test 6: Platform-specific checks
+console.log('6️⃣ Testing platform-specific features...');
+try {
+  console.log(`Platform: ${os.platform()}`);
+  console.log(`Architecture: ${os.arch()}`);
+  console.log(`Node version: ${process.version}`);
+  console.log(`Working directory: ${process.cwd()}`);
+
+  // Test process.argv handling
+  console.log(`Arguments count: ${process.argv.length}`);
+  console.log(`First argument: ${process.argv[0]}`);
+  console.log(`Script name: ${process.argv[1]}`);
+
+  console.log('✅ Platform detection works\n');
+}
+catch (error) {
+  console.error('❌ Platform testing failed:', error.message);
+  process.exit(1);
+}
+
+console.log('🎉 All cross-platform tests passed!');
+console.log('\n📋 Recommendations for Windows testing:');
+console.log('1. Test on Windows PowerShell/Command Prompt');
+console.log('2. Test with different Node.js versions (18.x, 20.x)');
+console.log('3. Test with and without Bun installed');
+console.log('4. Test global installation: npm install -g trello-cli-unofficial');
+console.log('5. Test PATH configuration and command availability'); ;

package/src/infrastructure/repositories/FileConfigRepository.ts

@@ -9,10 +9,9 @@ export class FileConfigRepository implements ConfigRepository {
   private readonly configFile: string;
 
   constructor() {
-    this.configDir = path.join(
-      process.env.HOME || '~',
-      '.trello-cli-unofficial',
-    );
+    // Cross-platform home directory detection
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '~';
+    this.configDir = path.join(homeDir, '.trello-cli-unofficial');
     this.configFile = path.join(this.configDir, 'config.json');
   }