codecrypto-cli 1.0.9 → 1.0.11

package/README.md

@@ -1,22 +1,18 @@
 # CodeCrypto CLI
 
-CLI tool for CodeCrypto operations - Deploy, manage users, configure settings, and handle database operations.
+CLI tool para desplegar aplicaciones Next.js/Express y smart contracts con Foundry.
 
 ## Instalación
 
-### Usando NPX (sin instalación)
 ```bash
+# Usando NPX (sin instalación)
 npx codecrypto-cli [command]
-```
 
-### Instalación Global
-```bash
+# Instalación global
 npm install -g codecrypto-cli
 codecrypto [command]
-```
 
-### Instalación Local (desarrollo)
-```bash
+# Desarrollo local
 git clone <repository>
 cd cli-cc
 npm install
@@ -24,527 +20,370 @@ npm run build
 npm link
 ```
 
-## Comandos Disponibles
+## Comandos
 
-### 📦 Deploy
+### 🔐 `auth` - Autenticación
 
-Despliega tu aplicación en diferentes entornos.
+Autentica el CLI con el servidor CodeCrypto.
 
 ```bash
-# Despliegue básico
-codecrypto deploy
-
-# Despliegue con opciones
-codecrypto deploy --env prod --branch main --region us-west-2
-
-# Despliegue sin tests
-codecrypto deploy --skip-tests
-
-# Simulación (dry-run)
-codecrypto deploy --dry-run
+codecrypto auth
+codecrypto auth --force  # Forzar renovación de token
 ```
 
-**Opciones:**
-- `-e, --env <environment>` - Entorno (dev, staging, prod). Default: `dev`
-- `-b, --branch <branch>` - Rama de Git. Default: `main`
-- `-r, --region <region>` - Región AWS. Default: `us-east-1`
-- `--skip-tests` - Omitir tests antes del deployment
-- `--dry-run` - Simular sin ejecutar
-
-**Ejemplos:**
-```bash
-# Desplegar a producción desde rama release
-codecrypto deploy -e prod -b release
-
-# Desplegar a staging sin tests
-codecrypto deploy -e staging --skip-tests
-
-# Simular despliegue a producción
-codecrypto deploy -e prod --dry-run
-```
+**Funcionamiento:**
+- Genera código de autenticación
+- Abre navegador para autorizar
+- Guarda token en `~/.codecrypto/token.json`
+- Incluye certificados Docker en `adminGlobals`
 
 ---
 
-### 👤 User
+### 🏥 `doctor` - Validación del Sistema
 
-Gestiona usuarios en el sistema.
-
-#### Crear Usuario
+Valida todos los requisitos necesarios para desplegar.
 
 ```bash
-# Modo interactivo
-codecrypto user create --interactive
-
-# Con parámetros
-codecrypto user create -u john_doe -e john@example.com -r admin
-
-# Modo mixto (parámetros + interactivo)
-codecrypto user create -u john_doe --interactive
+codecrypto doctor
+codecrypto doctor --verbose
 ```
 
-**Opciones:**
-- `-u, --username <username>` - Nombre de usuario
-- `-e, --email <email>` - Correo electrónico
-- `-r, --role <role>` - Rol (admin, user, guest). Default: `user`
-- `--interactive` - Modo interactivo
-
-**Ejemplos:**
-```bash
-# Crear admin
-codecrypto user create -u admin_user -e admin@company.com -r admin
-
-# Crear usuario guest
-codecrypto user create -u guest01 -e guest@example.com -r guest
-```
-
-#### Listar Usuarios
-
-```bash
-# Listar todos
-codecrypto user list
-
-# Filtrar por rol
-codecrypto user list -r admin
-
-# Limitar resultados
-codecrypto user list -l 5
-```
-
-**Opciones:**
-- `-r, --role <role>` - Filtrar por rol
-- `-l, --limit <number>` - Límite de resultados. Default: `10`
-
-#### Eliminar Usuario
-
-```bash
-# Con confirmación
-codecrypto user delete 123
-
-# Sin confirmación (forzar)
-codecrypto user delete 123 --force
-```
-
-**Opciones:**
-- `-f, --force` - Omitir confirmación
+**Valida:**
+- ✅ Node.js y npm
+- ✅ Docker y Docker Buildx
+- ✅ Docker Hub authentication
+- ✅ CodeCrypto token
+- ✅ Certificados Docker (desde token.json)
+- ✅ Git
+- ✅ Foundry (forge, cast, anvil)
+- ✅ Anvil corriendo (puerto 55556)
+- ✅ Acceso a cuenta Anvil 0
 
 ---
 
-### ⚙️ Config
-
-Gestiona la configuración del CLI.
-
-#### Set (Establecer valor)
-
-```bash
-# Configuración local
-codecrypto config set api.url https://api.example.com
-
-# Configuración global
-codecrypto config set api.token my-secret-token --global
-```
-
-**Opciones:**
-- `-g, --global` - Configuración global
+### 🐳 `deploy` - Despliegue de Aplicaciones
 
-**Ejemplos:**
-```bash
-codecrypto config set default.region us-west-2
-codecrypto config set api.timeout 5000 --global
-```
-
-#### Get (Obtener valor)
-
-```bash
-codecrypto config get api.url
-codecrypto config get default.region
-```
+Despliega aplicaciones **Next.js** o **Express** usando Docker.
 
-#### List (Listar configuración)
+**Detección automática:** Analiza `package.json` para detectar el tipo:
+- Si tiene `next` → Next.js
+- Si tiene `express` → Express
 
 ```bash
-# Configuración local
-codecrypto config list
+# Básico
+codecrypto deploy <project-path>
 
-# Configuración global
-codecrypto config list --global
+# Con opciones
+codecrypto deploy <project-path> [dest-folder] \
+  --deploy \
+  --service-name mi-app \
+  --port 3000 \
+  --domain-base proyectos.codecrypto.academy \
+  --env-file .env \
+  --image-version 1.0.0 \
+  --skip-build \
+  --no-push \
+  --skip-git-check
 ```
 
 **Opciones:**
-- `-g, --global` - Mostrar configuración global
+- `<project-path>` - Ruta al proyecto (requerido)
+- `[dest-folder]` - Carpeta destino para build Docker (default: `./docker-build`)
+- `--deploy` - Desplegar en servidor remoto después del build
+- `--service-name <name>` - Nombre del servicio para Traefik
+- `--port <port>` - Puerto de la aplicación (default: `3000`)
+- `--domain-base <domain>` - Dominio base (default: `proyectos.codecrypto.academy`)
+- `--env-file <path>` - Archivo `.env` con variables de entorno
+- `--image-version <version>` - Versión/tag de la imagen (sobrescribe package.json)
+- `--skip-build` - Omitir `npm run build`
+- `--no-push` - Construir pero no hacer push a Docker Hub
+- `--skip-git-check` - Omitir verificación de estado Git
+
+**Proceso:**
+1. Detecta tipo de proyecto (Next.js/Express)
+2. Valida estado Git (a menos que se omita)
+3. Build del proyecto (si no se omite)
+4. Genera Dockerfile optimizado
+5. Construye imagen multi-plataforma (linux/amd64, linux/arm64)
+6. Push a Docker Hub (si no se omite)
+7. Despliega en servidor remoto (si `--deploy`)
+
+**Dockerfile generado:**
+- **Next.js:** Usa `node:20-alpine`, copia `.next/standalone`, `.next/static`, `public`
+- **Express:** Usa `node:20-alpine`, multi-stage build, solo dependencias de producción
+
+**Certificados Docker:**
+- Se leen desde `~/.codecrypto/token.json` → `adminGlobals`
+- Keys: `docker-client/ca-pem`, `docker-client/cert.pem`, `docker-client/key.pem`
 
 ---
 
-### 💾 Database (db)
-
-Operaciones de base de datos.
+### 🔷 `deploy-sc` - Despliegue de Smart Contracts
 
-#### Migraciones
+Despliega smart contracts usando **Foundry**.
 
 ```bash
-# Ejecutar migraciones
-codecrypto db migrate
-
-# Ejecutar en producción
-codecrypto db migrate -e prod
+# Básico
+codecrypto deploy-sc <script-path>
 
-# Rollback última migración
-codecrypto db migrate --rollback
-
-# Rollback 3 migraciones
-codecrypto db migrate --rollback --steps 3
+# Con opciones
+codecrypto deploy-sc <script-path> \
+  --url http://localhost:8545 \
+  --private-key 0x... \
+  --account 0 \
+  --anvil \
+  --broadcast \
+  --verify \
+  --slow \
+  --debug
 ```
 
 **Opciones:**
-- `-e, --env <environment>` - Entorno. Default: `dev`
-- `--rollback` - Revertir migración
-- `--steps <number>` - Número de migraciones. Default: `all`
-
-#### Seed (Poblar datos)
+- `<script-path>` - Ruta al script Foundry `.s.sol` (requerido)
+- `-u, --url <rpc-url>` - URL RPC (default: `http://server.codecrypto.academy:8546`)
+- `-k, --private-key <key>` - Clave privada (o usar `PRIVATE_KEY` env var)
+- `--account <index>` - Índice de cuenta (para Anvil, usa `0`)
+- `--anvil` - Forzar uso de cuenta Anvil 0 (ignora private-key)
+- `--verify` - Verificar contrato en block explorer
+- `--broadcast` - Transmitir transacción (default: `true`)
+- `--slow` - Modo lento para deployment
+- `--debug` - Mostrar información de debug
+
+**Proceso:**
+1. Valida que el script existe y es `.s.sol`
+2. Detecta proyecto Foundry (busca `foundry.toml`)
+3. Ejecuta `forge script` con configuración
+4. Guarda resultados en `broadcast/`
+5. Sube transacciones a BD vía `/api/uploadSmartContract`
+
+**Datos subidos a BD:**
+- Email del usuario
+- Carpeta del proyecto
+- JSON completo de transacciones (`run-latest.json`)
+- RPC URL usado
+- Clave privada (o `account-{index}`)
 
-```bash
-# Seed básico
-codecrypto db seed
-
-# Limpiar y seed
-codecrypto db seed --clear
-
-# Seed archivo específico
-codecrypto db seed -f users.sql
-
-# Seed en staging
-codecrypto db seed -e staging
-```
+---
 
-**Opciones:**
-- `-e, --env <environment>` - Entorno. Default: `dev`
-- `-f, --file <file>` - Archivo seed específico
-- `--clear` - Limpiar datos existentes
+## Ejemplos de Uso
 
-#### Backup
+### Desplegar aplicación Next.js
 
 ```bash
-# Crear backup
-codecrypto db backup my-backup
-
-# Backup de producción
-codecrypto db backup prod-backup -e prod
+# Build y push a Docker Hub
+codecrypto deploy ../mi-app-nextjs
 
-# Backup sin comprimir
-codecrypto db backup test-backup --compress false
-
-# Especificar directorio
-codecrypto db backup daily-backup -o /backups/daily
+# Build, push y deploy en servidor
+codecrypto deploy ../mi-app-nextjs \
+  --deploy \
+  --service-name mi-app \
+  --env-file ../mi-app-nextjs/.env
 ```
 
-**Opciones:**
-- `-e, --env <environment>` - Entorno origen. Default: `prod`
-- `-o, --output <path>` - Directorio de salida. Default: `./backups`
-- `--compress` - Comprimir archivo. Default: `true`
-
-#### Restore
+### Desplegar aplicación Express
 
 ```bash
-# Restaurar en dev
-codecrypto db restore backup_2024-01-15.sql.gz
-
-# Restaurar en staging
-codecrypto db restore backup.sql -e staging
+# Build y push
+codecrypto deploy ../mi-api-express
 
-# Restaurar en prod (requiere --force)
-codecrypto db restore backup.sql -e prod --force
+# Con variables de entorno
+codecrypto deploy ../mi-api-express \
+  --env-file ../mi-api-express/.env \
+  --port 3000
 ```
 
-**Opciones:**
-- `-e, --env <environment>` - Entorno destino. Default: `dev`
-- `--force` - Omitir confirmación (requerido para prod)
-
----
-
-## Ayuda
+### Desplegar Smart Contract
 
 ```bash
-# Ayuda general
-codecrypto --help
+# En Anvil local
+codecrypto deploy-sc ./script/Deploy.s.sol \
+  --url http://localhost:8545 \
+  --anvil \
+  --broadcast
 
-# Ayuda de comando específico
-codecrypto deploy --help
-codecrypto user --help
-codecrypto user create --help
-codecrypto db --help
-codecrypto db migrate --help
+# En red remota con clave privada
+codecrypto deploy-sc ./script/Deploy.s.sol \
+  --url http://server.codecrypto.academy:8546 \
+  --private-key 0x1234567890abcdef... \
+  --broadcast \
+  --verify
 ```
 
-## Ejemplos de Uso Completo
+### Workflow completo
 
-### Workflow de Deployment
 ```bash
-# 1. Configurar ambiente
-codecrypto config set api.url https://api.myapp.com
-codecrypto config set default.region us-east-1
+# 1. Validar sistema
+codecrypto doctor
 
-# 2. Ejecutar migraciones
-codecrypto db migrate -e staging
+# 2. Autenticarse (si es necesario)
+codecrypto auth
 
-# 3. Deploy a staging
-codecrypto deploy -e staging -b develop
+# 3. Desplegar aplicación
+codecrypto deploy ../mi-app --deploy
 
-# 4. Si todo OK, deploy a producción
-codecrypto deploy -e prod -b main
+# 4. Desplegar smart contract
+codecrypto deploy-sc ./script/Deploy.s.sol --anvil
 ```
 
-### Setup Inicial de DB
-```bash
-# 1. Crear backup de seguridad
-codecrypto db backup safety-backup -e prod
-
-# 2. Ejecutar migraciones
-codecrypto db migrate -e dev
-
-# 3. Poblar datos de prueba
-codecrypto db seed --clear
-```
-
-### Gestión de Usuarios
-```bash
-# Crear varios usuarios
-codecrypto user create -u admin -e admin@co.com -r admin
-codecrypto user create -u user1 -e user1@co.com -r user
-codecrypto user create -u guest1 -e guest1@co.com -r guest
-
-# Listar usuarios admin
-codecrypto user list -r admin
-
-# Eliminar usuario
-codecrypto user delete 5 --force
-```
+---
 
-## Desarrollo
+## Estructura del Proyecto
 
-### Estructura del Proyecto
 ```
 cli-cc/
 ├── src/
 │   ├── index.ts              # Punto de entrada
 │   └── commands/
-│       ├── deploy.ts         # Comando deploy
-│       ├── user.ts           # Comando user
-│       ├── config.ts         # Comando config
-│       └── database.ts       # Comando db
+│       ├── auth.ts           # Autenticación
+│       ├── deploy.ts         # Deploy Next.js/Express
+│       ├── deploy-sc.ts      # Deploy Smart Contracts
+│       └── doctor.ts         # Validación del sistema
 ├── dist/                     # Build output
 ├── package.json
 ├── tsconfig.json
 └── README.md
 ```
 
-### Scripts de Desarrollo
+---
+
+## Desarrollo
 
 ```bash
 # Instalar dependencias
 npm install
 
-# Desarrollo (ejecutar sin compilar)
+# Desarrollo (sin compilar)
 npm run dev -- deploy --help
 
 # Compilar
 npm run build
 
-# Probar compilado
-npm run test
-
-# Testear localmente con npm link
+# Probar localmente
 npm link
 codecrypto --help
 ```
 
-### Compilar y Probar
-
-```bash
-# Build
-npm run build
-
-# Probar comando compilado
-node dist/index.js --help
-node dist/index.js deploy --dry-run
-node dist/index.js user create --interactive
-```
-
-## Publicación a NPM
-
-### 1. Preparación
-
-Asegúrate de tener una cuenta en [npmjs.com](https://www.npmjs.com/) y estar logueado:
+---
 
-```bash
-npm login
-```
+## Configuración
 
-### 2. Actualizar package.json
+### Token de autenticación
 
-Verifica que tu `package.json` tenga:
-- `name`: Nombre único en NPM (verifica disponibilidad en npmjs.com)
-- `version`: Versión semántica (ej: 1.0.0)
-- `description`: Descripción clara
-- `keywords`: Para búsquedas
-- `author`: Tu información
-- `license`: Tipo de licencia
-- `bin`: Configurado correctamente
-- `files`: Archivos a incluir (opcional)
+Guardado en: `~/.codecrypto/token.json`
 
 ```json
 {
-  "name": "codecrypto-cli",
-  "version": "1.0.0",
-  "files": ["dist", "README.md"],
-  ...
+  "email": "usuario@example.com",
+  "token": "jwt-token",
+  "serverUrl": "http://server.codecrypto.academy",
+  "adminGlobals": [
+    {
+      "key": "docker-client/ca-pem",
+      "value": "..."
+    },
+    {
+      "key": "docker-client/cert.pem",
+      "value": "..."
+    },
+    {
+      "key": "docker-client/key.pem",
+      "value": "..."
+    }
+  ]
 }
 ```
 
-### 3. Verificar el nombre
+### Variables de entorno
 
-```bash
-# Verificar si el nombre está disponible
-npm search codecrypto-cli
-```
+El CLI puede leer variables de entorno de dos formas:
 
-Si está ocupado, cambia el nombre en `package.json`:
-```json
-{
-  "name": "@tu-usuario/codecrypto-cli"
-}
-```
+#### 1. Variables del sistema operativo
 
-### 4. Build Final
+Configura las variables en tu shell:
 
 ```bash
-npm run build
-```
-
-### 5. Probar el paquete localmente
-
-```bash
-# Simular publicación (ver qué archivos se incluirán)
-npm pack
-
-# Esto crea un archivo .tgz que puedes inspeccionar
-# Descomprímelo y verifica el contenido
-```
-
-### 6. Publicar
-
-```bash
-# Publicación pública
-npm publish
-
-# Si usas scoped package (@usuario/nombre)
-npm publish --access public
-```
-
-### 7. Verificar
+# Linux/Mac
+export CODECRYPTO_API_URL=http://server.codecrypto.academy:3000
+export API_URL=http://server.codecrypto.academy:3000
 
-```bash
-# Probar instalación
-npx codecrypto-cli@latest --help
+# Windows (PowerShell)
+$env:CODECRYPTO_API_URL="http://server.codecrypto.academy:3000"
+$env:API_URL="http://server.codecrypto.academy:3000"
 
-# O con el nombre real de tu paquete
-npx tu-paquete --help
+# Windows (CMD)
+set CODECRYPTO_API_URL=http://server.codecrypto.academy:3000
+set API_URL=http://server.codecrypto.academy:3000
 ```
 
-### 8. Actualizar Versiones
+#### 2. Archivo `.env` (recomendado)
 
-Cuando hagas cambios:
+Crea un archivo `~/.codecrypto/.env` con tus variables:
 
 ```bash
-# Patch (1.0.0 -> 1.0.1) - bug fixes
-npm version patch
-
-# Minor (1.0.0 -> 1.1.0) - nuevas features
-npm version minor
-
-# Major (1.0.0 -> 2.0.0) - breaking changes
-npm version major
+# El folder ~/.codecrypto se crea automáticamente cuando ejecutas 'codecrypto auth' por primera vez
+# O puedes crearlo manualmente:
+mkdir -p ~/.codecrypto
 
-# Publicar nueva versión
-npm publish
+# Crear archivo .env
+cat > ~/.codecrypto/.env << EOF
+CODECRYPTO_API_URL=http://server.codecrypto.academy:3000
+# O usar API_URL como alternativa
+# API_URL=http://server.codecrypto.academy:3000
+EOF
 ```
 
-### Workflow Completo de Publicación
+**Nota:** El folder `~/.codecrypto` se crea automáticamente la primera vez que ejecutas `codecrypto auth`, pero puedes crearlo manualmente antes si lo necesitas.
 
-```bash
-# 1. Asegurarte que todo funciona
-npm run build
-npm run test
+**Variables disponibles:**
+- `CODECRYPTO_API_URL` o `API_URL` - URL del servidor API (default: `http://localhost:3000`)
 
-# 2. Login a NPM
-npm login
+**Nota:** Las variables del sistema operativo tienen prioridad sobre el archivo `.env`.
 
-# 3. Verificar nombre disponible
-npm search codecrypto-cli
+---
 
-# 4. Publicar
-npm publish --access public
+## Requisitos
 
-# 5. Verificar
-npx codecrypto-cli --help
+- Node.js >= 16.0.0
+- Docker y Docker Buildx
+- Git
+- Foundry (forge, cast, anvil)
+- Anvil corriendo en puerto 55556 (para smart contracts locales)
 
-# 6. Para actualizaciones futuras
-npm version patch
-npm publish
-```
+---
 
-### Despublicar (si es necesario)
+## Ayuda
 
 ```bash
-# Solo dentro de las primeras 72 horas
-npm unpublish codecrypto-cli@1.0.0
+# Ayuda general
+codecrypto --help
 
-# Despublicar todas las versiones (usar con cuidado)
-npm unpublish codecrypto-cli --force
+# Ayuda de comando específico
+codecrypto deploy --help
+codecrypto deploy-sc --help
+codecrypto auth --help
+codecrypto doctor --help
 ```
 
-## Mejores Prácticas
-
-1. **Versionado Semántico**: Usa [semver](https://semver.org/)
-   - MAJOR: Cambios incompatibles
-   - MINOR: Nuevas funcionalidades compatibles
-   - PATCH: Bug fixes
-
-2. **README**: Mantén documentación actualizada
-
-3. **CHANGELOG**: Documenta cambios en cada versión
+---
 
-4. **Testing**: Prueba antes de publicar
+## Publicación a NPM
 
-5. **Git Tags**: Crea tags para cada versión
-   ```bash
-   git tag v1.0.0
-   git push --tags
-   ```
+```bash
+# 1. Build
+npm run build
 
-## Troubleshooting
+# 2. Login
+npm login
 
-### Error: "command not found"
-- Verifica que `bin` en package.json apunte a `dist/index.js`
-- El archivo debe tener shebang: `#!/usr/bin/env node`
-- Asegúrate de compilar: `npm run build`
+# 3. Publicar
+npm publish
 
-### Error: "permission denied"
-```bash
-# Linux/Mac
-chmod +x dist/index.js
+# 4. Actualizar versión
+npm version patch|minor|major
+npm publish
 ```
 
-### Error al publicar
-- Verifica que estés logueado: `npm whoami`
-- El nombre no existe: Cambia el nombre en package.json
-- Necesitas acceso: Usa `--access public` para scoped packages
-
-## Recursos
-
-- [Commander.js](https://github.com/tj/commander.js) - Framework CLI
-- [Chalk](https://github.com/chalk/chalk) - Colores en terminal
-- [Inquirer](https://github.com/SBoudrias/Inquirer.js) - Prompts interactivos
-- [Ora](https://github.com/sindresorhus/ora) - Spinners
-- [NPM Publishing Guide](https://docs.npmjs.com/cli/v10/commands/npm-publish)
+---
 
 ## Licencia