unified-tvdevelopment-cli 1.0.0

package/docs/RELEASE.md

@@ -0,0 +1,37 @@
+# Release Process
+
+## Quick release
+
+```bash
+npm version patch   # or minor / major
+git push origin main --follow-tags
+```
+
+The `npm version` command:
+1. Updates `package.json` version
+2. Creates a git commit (`chore(release): vX.Y.Z`)
+3. Creates a git tag (`vX.Y.Z`)
+
+Pushing the tag triggers the `release.yml` workflow which:
+- Runs tests
+- Validates tag matches `package.json`
+- Publishes to npm
+- Creates a GitHub Release
+
+## Pre-releases (beta)
+
+```bash
+npm version prerelease --preid=beta   # e.g. 1.0.1-beta.0
+git push origin main --follow-tags
+```
+
+Beta releases publish to npm with `--tag beta` and are marked as pre-release on GitHub.
+
+## Platform CLI dependencies
+
+| Platform | Required tools |
+|---|---|
+| LG webOS | `npm install -g @webosose/ares-cli` |
+| Samsung Tizen | Tizen Studio (tizen + sdb) |
+| Amazon Fire TV | `adb` (Android Platform Tools) + `inputd-cli` + `LoggingCtl` |
+| Android TV | Android SDK (`adb`, `gradle`, `avdmanager`, `emulator`) |

package/install.ps1

@@ -0,0 +1,171 @@
+# unified-tvdevelopment-cli — Windows installer
+# Run:
+#   iwr -useb https://raw.githubusercontent.com/FernandoHaeser/unified-tvdevelopment-cli/main/install.ps1 | iex
+#   iwr -useb https://raw.githubusercontent.com/FernandoHaeser/unified-tvdevelopment-cli/main/install.ps1 | iex  # then pass -Beta
+
+param(
+  [switch]$Beta,
+  [string]$Tag = "latest"
+)
+
+$ErrorActionPreference = 'Stop'
+$Package = "unified-tvdevelopment-cli"
+$Bin     = "tvdev"
+$RequiredNodeMajor = 18
+
+if ($Beta) { $Tag = "beta" }
+
+# ── Helpers ───────────────────────────────────────────────────────────────────
+function Write-Banner {
+  Write-Host ""
+  Write-Host "  [TV Dev Manager]" -ForegroundColor Cyan -NoNewline
+  if ($Tag -ne "latest") {
+    Write-Host "  tag: $Tag" -ForegroundColor Yellow
+  } else {
+    Write-Host ""
+  }
+  Write-Host "  Universal Smart TV Development CLI" -ForegroundColor DarkGray
+  Write-Host "  LG webOS · Samsung Tizen · Amazon Fire TV · Android TV" -ForegroundColor DarkGray
+  Write-Host ""
+}
+
+function Write-Step { param($msg) Write-Host "`n  > $msg" -ForegroundColor Cyan }
+function Write-Ok   { param($msg) Write-Host "  [OK] $msg" -ForegroundColor Green }
+function Write-Info { param($msg) Write-Host "  [..] $msg" -ForegroundColor Blue }
+function Write-Warn { param($msg) Write-Host "  [!!] $msg" -ForegroundColor Yellow }
+function Write-Fail { param($msg) Write-Host "`n  [XX] $msg`n" -ForegroundColor Red; exit 1 }
+
+function Get-SemverParts {
+  param([string]$v)
+  $core = ($v -split '-')[0]
+  return ($core -split '\.' | ForEach-Object { [int]$_ })
+}
+
+function Compare-Version {
+  param([string]$installed, [string]$latest)
+  $a = Get-SemverParts $installed
+  $b = Get-SemverParts $latest
+  for ($i = 0; $i -lt [Math]::Max($a.Count, $b.Count); $i++) {
+    $av = if ($i -lt $a.Count) { $a[$i] } else { 0 }
+    $bv = if ($i -lt $b.Count) { $b[$i] } else { 0 }
+    if ($av -gt $bv) { return 1 }
+    if ($av -lt $bv) { return -1 }
+  }
+  return 0
+}
+
+Write-Banner
+
+# ── Idempotency ───────────────────────────────────────────────────────────────
+Write-Step "Checking existing installation"
+
+$installedVer = ""
+$latestVer    = ""
+
+if (Get-Command $Bin -ErrorAction SilentlyContinue) {
+  try {
+    $installedVer = (npm list -g --depth=0 $Package 2>$null | Select-String $Package) `
+      -replace ".*@", "" | ForEach-Object { $_.Trim() }
+    $latestVer = (npm show "${Package}@${Tag}" version 2>$null).Trim()
+  } catch {}
+
+  Write-Ok "$Bin already installed"
+  if ($installedVer) { Write-Info "Installed : $installedVer" }
+  if ($latestVer)    { Write-Info "Latest    : $latestVer ($Tag)" }
+
+  if ($installedVer -and $latestVer -and (Compare-Version $installedVer $latestVer) -ge 0) {
+    Write-Ok "Already up to date — nothing to do"
+    Write-Host "`n  Run: $Bin`n" -ForegroundColor Cyan
+    exit 0
+  }
+
+  Write-Info "Update available — reinstalling"
+} else {
+  Write-Info "$Bin not yet installed — starting fresh install"
+}
+
+# ── Node.js ───────────────────────────────────────────────────────────────────
+Write-Step "Checking Node.js"
+
+if (-not (Get-Command node -ErrorAction SilentlyContinue)) {
+  Write-Warn "Node.js not found."
+  Write-Host "  Install from https://nodejs.org (LTS recommended)" -ForegroundColor DarkGray
+  Write-Host "  Or via winget: winget install OpenJS.NodeJS.LTS" -ForegroundColor DarkGray
+  Write-Fail "Node.js $RequiredNodeMajor+ required."
+}
+
+$nodeVer   = (node --version).TrimStart('v')
+$nodeMajor = [int]($nodeVer -split '\.')[0]
+
+if ($nodeMajor -lt $RequiredNodeMajor) {
+  Write-Fail "Node.js $RequiredNodeMajor+ required (got v$nodeVer). Upgrade: https://nodejs.org"
+}
+
+Write-Ok "Node.js v$nodeVer"
+
+# ── npm ───────────────────────────────────────────────────────────────────────
+Write-Step "Checking npm"
+
+if (-not (Get-Command npm -ErrorAction SilentlyContinue)) {
+  Write-Fail "npm not found. Reinstall Node.js from https://nodejs.org"
+}
+
+Write-Ok "npm $(npm --version)"
+
+# ── Install ───────────────────────────────────────────────────────────────────
+Write-Step "Installing ${Package}@${Tag}"
+Write-Info "Running: npm install -g ${Package}@${Tag}"
+Write-Host ""
+
+npm install -g "${Package}@${Tag}" 2>&1 | Where-Object { $_ -notmatch "^npm warn" -and $_.Trim() -ne "" }
+
+Write-Host ""
+Write-Ok "$Package installed"
+
+# ── Verify ────────────────────────────────────────────────────────────────────
+Write-Step "Verifying"
+
+try {
+  $binPath = (Get-Command $Bin -ErrorAction Stop).Path
+  Write-Ok "$Bin → $binPath"
+} catch {
+  Write-Warn "$Bin not found in PATH. Restart your terminal and try again."
+}
+
+# ── Platform tools ────────────────────────────────────────────────────────────
+Write-Step "Checking platform-specific tools"
+
+if (Get-Command "ares-setup-device" -ErrorAction SilentlyContinue) {
+  Write-Ok "ares-cli (LG webOS) found"
+} else {
+  Write-Warn "ares-cli not found → npm install -g @webosose/ares-cli"
+}
+
+if (Get-Command "sdb" -ErrorAction SilentlyContinue) {
+  Write-Ok "sdb (Samsung Tizen) found"
+} else {
+  Write-Warn "sdb not found → install Tizen Studio: developer.samsung.com/smarttv"
+}
+
+if (Get-Command "adb" -ErrorAction SilentlyContinue) {
+  Write-Ok "adb (Fire TV / Android TV) found"
+} else {
+  Write-Warn "adb not found → install Android SDK Platform Tools"
+}
+
+if (Get-Command "inputd-cli" -ErrorAction SilentlyContinue) {
+  Write-Ok "inputd-cli (Fire TV input) found"
+} else {
+  Write-Warn "inputd-cli not found (optional — Fire TV remote input simulation)"
+}
+
+# ── Done ──────────────────────────────────────────────────────────────────────
+Write-Host ""
+Write-Host "  Installation complete!" -ForegroundColor Green
+Write-Host ""
+Write-Host "  Launch TV Dev Manager: " -NoNewline
+Write-Host $Bin -ForegroundColor Cyan
+Write-Host ""
+Write-Host "  GitHub : https://github.com/FernandoHaeser/unified-tvdevelopment-cli" -ForegroundColor DarkGray
+Write-Host "  npm    : https://npmjs.com/package/unified-tvdevelopment-cli" -ForegroundColor DarkGray
+Write-Host ""

package/install.sh

@@ -0,0 +1,226 @@
+#!/usr/bin/env bash
+# unified-tvdevelopment-cli — one-line installer
+# Supports: LG webOS, Samsung Tizen, Amazon Fire TV, Android TV
+#
+#   curl -fsSL https://raw.githubusercontent.com/FernandoHaeser/unified-tvdevelopment-cli/main/install.sh | bash
+#   curl -fsSL https://raw.githubusercontent.com/FernandoHaeser/unified-tvdevelopment-cli/main/install.sh | bash -s -- --beta
+#
+set -euo pipefail
+
+PACKAGE="unified-tvdevelopment-cli"
+BIN="tvdev"
+REQUIRED_NODE=18
+NVM_VERSION="v0.39.7"
+INSTALL_NODE_VERSION="20"
+NPM_TAG="latest"
+
+# ── Flags ─────────────────────────────────────────────────────────────────────
+for arg in "${@:-}"; do
+  case "$arg" in
+    --beta)           NPM_TAG="beta" ;;
+    --tag=*)          NPM_TAG="${arg#--tag=}" ;;
+    --tag)            shift; NPM_TAG="${1:-latest}" ;;
+  esac
+done
+
+# ── Colors ────────────────────────────────────────────────────────────────────
+if [ -t 1 ]; then
+  INDIGO='\033[38;5;99m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+  RED='\033[0;31m'; BOLD='\033[1m'; DIM='\033[2m'; RESET='\033[0m'
+else
+  INDIGO=''; GREEN=''; YELLOW=''; RED=''; BOLD=''; DIM=''; RESET=''
+fi
+
+# ── Helpers ───────────────────────────────────────────────────────────────────
+banner() {
+  echo ""
+  echo -e "${BOLD}${INDIGO}  ◉  TV Dev Manager${RESET}"
+  echo -e "  ${INDIGO}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+  echo -e "  ${DIM}Universal Smart TV Development CLI${RESET}"
+  echo -e "  ${DIM}LG webOS · Samsung Tizen · Amazon Fire TV · Android TV${RESET}"
+  if [ "$NPM_TAG" != "latest" ]; then
+    echo -e "  ${YELLOW}  tag: ${NPM_TAG}${RESET}"
+  fi
+  echo ""
+}
+
+step()  { echo -e "\n${BOLD}${INDIGO}  ▶  $*${RESET}"; }
+ok()    { echo -e "  ${GREEN}✓${RESET}  $*"; }
+info()  { echo -e "  ${INDIGO}●${RESET}  $*"; }
+warn()  { echo -e "  ${YELLOW}⚠${RESET}  $*"; }
+fail()  { echo -e "\n  ${RED}✗  $*${RESET}\n"; exit 1; }
+
+# ── Semver compare (returns 0 if $1 >= $2) ────────────────────────────────────
+semver_gte() {
+  # strip pre-release suffix for comparison
+  local a b
+  a=$(echo "$1" | sed 's/-.*//')
+  b=$(echo "$2" | sed 's/-//')
+  [ "$(printf '%s\n%s\n' "$a" "$b" | sort -V | head -1)" = "$b" ]
+}
+
+detect_shell_rc() {
+  case "${SHELL:-}" in
+    */zsh)  echo "$HOME/.zshrc"  ;;
+    */bash)
+      [ -f "$HOME/.bash_profile" ] && echo "$HOME/.bash_profile" || echo "$HOME/.bashrc"
+      ;;
+    */fish) echo "$HOME/.config/fish/config.fish" ;;
+    *)      echo "$HOME/.profile" ;;
+  esac
+}
+
+idempotent_path_export() {
+  local bin_dir rc_file export_line
+  bin_dir=$(npm prefix -g 2>/dev/null)/bin
+  rc_file=$(detect_shell_rc)
+
+  if echo ":${PATH}:" | grep -q ":${bin_dir}:"; then
+    ok "PATH already contains npm global bin"
+    return
+  fi
+
+  if [[ "${SHELL:-}" == */fish ]]; then
+    export_line="set -gx PATH \$PATH ${bin_dir}"
+  else
+    export_line="export PATH=\"\$PATH:${bin_dir}\""
+  fi
+
+  if [ -f "$rc_file" ] && grep -qF "$bin_dir" "$rc_file" 2>/dev/null; then
+    ok "PATH entry already in ${rc_file}"
+    return
+  fi
+
+  echo "" >> "$rc_file"
+  echo "# added by unified-tvdevelopment-cli installer" >> "$rc_file"
+  echo "$export_line" >> "$rc_file"
+  ok "Added PATH entry to ${rc_file}"
+  export PATH="${PATH}:${bin_dir}"
+}
+
+# ── Idempotency check ─────────────────────────────────────────────────────────
+banner
+
+step "Checking existing installation"
+
+INSTALLED_VER=""
+LATEST_VER=""
+
+if command -v "$BIN" &>/dev/null; then
+  INSTALLED_VER=$(npm list -g --depth=0 "$PACKAGE" 2>/dev/null \
+    | grep "$PACKAGE" | sed 's/.*@//' | tr -d '[:space:]' || true)
+  LATEST_VER=$(npm show "${PACKAGE}@${NPM_TAG}" version 2>/dev/null || true)
+
+  ok "${BIN} already installed"
+  [ -n "$INSTALLED_VER" ] && info "Installed : ${INSTALLED_VER}"
+  [ -n "$LATEST_VER"    ] && info "Latest    : ${LATEST_VER} (${NPM_TAG})"
+
+  if [ -n "$INSTALLED_VER" ] && [ -n "$LATEST_VER" ] && semver_gte "$INSTALLED_VER" "$LATEST_VER"; then
+    ok "Already up to date — nothing to do"
+    echo ""
+    echo -e "  ${BOLD}Run: ${INDIGO}${BIN}${RESET}"
+    echo ""
+    exit 0
+  fi
+
+  info "Update available — reinstalling"
+else
+  info "${BIN} not yet installed — starting fresh install"
+fi
+
+# ── Node.js ───────────────────────────────────────────────────────────────────
+step "Checking Node.js"
+
+install_node_via_nvm() {
+  warn "Node.js not found — installing via nvm"
+  export NVM_DIR="${HOME}/.nvm"
+  curl -fsSL "https://raw.githubusercontent.com/nvm-sh/nvm/${NVM_VERSION}/install.sh" | bash
+  [ -s "$NVM_DIR/nvm.sh" ] && source "$NVM_DIR/nvm.sh"
+  nvm install "$INSTALL_NODE_VERSION"
+  nvm use "$INSTALL_NODE_VERSION"
+  nvm alias default "$INSTALL_NODE_VERSION"
+  ok "Node.js $(node --version) installed via nvm"
+}
+
+if ! command -v node &>/dev/null; then
+  NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
+  if [ -s "$NVM_DIR/nvm.sh" ]; then
+    source "$NVM_DIR/nvm.sh"
+    if ! command -v node &>/dev/null; then
+      nvm install "$INSTALL_NODE_VERSION" && nvm use "$INSTALL_NODE_VERSION"
+    fi
+  else
+    install_node_via_nvm
+  fi
+fi
+
+! command -v node &>/dev/null && fail "Node.js install failed. Install manually: https://nodejs.org"
+
+NODE_MAJOR=$(node --version | sed 's/v//' | cut -d. -f1)
+[ "$NODE_MAJOR" -lt "$REQUIRED_NODE" ] && \
+  fail "Node.js ${REQUIRED_NODE}+ required (got $(node --version)). Upgrade: https://nodejs.org"
+
+ok "Node.js $(node --version)"
+
+# ── npm ───────────────────────────────────────────────────────────────────────
+step "Checking npm"
+! command -v npm &>/dev/null && fail "npm not found."
+ok "npm $(npm --version)"
+
+# ── Install ───────────────────────────────────────────────────────────────────
+step "Installing ${PACKAGE}@${NPM_TAG}"
+info "Running: npm install -g ${PACKAGE}@${NPM_TAG}"
+echo ""
+npm install -g "${PACKAGE}@${NPM_TAG}" 2>&1 | grep -v "^npm warn" | grep -v "^$" || true
+echo ""
+ok "${PACKAGE} installed"
+
+# ── PATH ──────────────────────────────────────────────────────────────────────
+step "Setting up PATH"
+idempotent_path_export
+hash -r 2>/dev/null || true
+
+if command -v "$BIN" &>/dev/null; then
+  ok "${BIN} is in PATH → $(command -v ${BIN})"
+else
+  warn "${BIN} not in PATH for this session. Restart terminal or:"
+  echo -e "\n    source $(detect_shell_rc)\n"
+fi
+
+# ── Platform tools ────────────────────────────────────────────────────────────
+step "Checking platform-specific tools"
+
+if command -v ares-setup-device &>/dev/null; then
+  ok "ares-cli (LG webOS) → $(command -v ares-setup-device)"
+else
+  warn "ares-cli not found → npm install -g @webosose/ares-cli"
+fi
+
+if command -v sdb &>/dev/null; then
+  ok "sdb (Samsung Tizen) → $(command -v sdb)"
+else
+  warn "sdb not found → install Tizen Studio: developer.samsung.com/smarttv"
+fi
+
+if command -v adb &>/dev/null; then
+  ok "adb (Fire TV / Android TV) → $(command -v adb)"
+else
+  warn "adb not found → brew install android-platform-tools  (or Android Studio SDK)"
+fi
+
+if command -v inputd-cli &>/dev/null; then
+  ok "inputd-cli (Fire TV input) → $(command -v inputd-cli)"
+else
+  warn "inputd-cli not found (optional — Fire TV remote input simulation)"
+fi
+
+# ── Done ──────────────────────────────────────────────────────────────────────
+echo ""
+echo -e "${BOLD}${INDIGO}  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+echo -e "${BOLD}${GREEN}  ✓  Installation complete!${RESET}"
+echo ""
+echo -e "  Launch TV Dev Manager:  ${BOLD}${INDIGO}${BIN}${RESET}"
+echo ""
+echo -e "  ${DIM}GitHub : https://github.com/FernandoHaeser/unified-tvdevelopment-cli${RESET}"
+echo -e "  ${DIM}npm    : https://npmjs.com/package/unified-tvdevelopment-cli${RESET}"
+echo ""

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "unified-tvdevelopment-cli",
+  "version": "1.0.0",
+  "description": "Universal TUI manager for Smart TV development — LG webOS, Samsung Tizen, Amazon Fire TV, Android TV",
+  "type": "module",
+  "bin": {
+    "tvdev": "dist/cli.mjs"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "mkdir -p dist && esbuild src/index.js --bundle --packages=external --platform=node --format=esm --outfile=dist/_bundle.mjs --loader:.js=jsx && printf '#!/usr/bin/env node\\n' | cat - dist/_bundle.mjs > dist/cli.mjs && chmod +x dist/cli.mjs && rm dist/_bundle.mjs",
+    "start": "npm run build && node dist/cli.mjs",
+    "dev": "npm run build && node dist/cli.mjs",
+    "prepare": "npm run build",
+    "test": "vitest run",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "test:e2e": "vitest run tests/e2e",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": [
+    "webos",
+    "tizen",
+    "android-tv",
+    "fire-tv",
+    "amazon",
+    "ares-cli",
+    "sdb",
+    "adb",
+    "tui",
+    "cli",
+    "smart-tv",
+    "lg",
+    "samsung"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tvdev-cli/unified-tvdevelopment-cli.git"
+  },
+  "files": [
+    "dist/",
+    "install.sh",
+    "install.ps1",
+    "README.md",
+    "docs/"
+  ],
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "execa": "^9.3.0",
+    "ink": "^5.0.1",
+    "ink-text-input": "^6.0.0",
+    "react": "^18.3.1"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^2.1.9",
+    "esbuild": "^0.28.0",
+    "vitest": "^2.1.9"
+  }
+}