codecrypto-cli 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,11 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm install)",
+      "Bash(npm run build:*)",
+      "Bash(node dist/index.js:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/PUBLISHING.md

@@ -0,0 +1,156 @@
+# Guía de Publicación a NPM
+
+## Solución al Error 403 (2FA Requerido)
+
+Tienes dos opciones:
+
+### Opción 1: Habilitar 2FA en tu cuenta NPM (Recomendado)
+
+1. **Ve a npmjs.com y habilita 2FA:**
+   - Visita: https://www.npmjs.com/settings/YOUR_USERNAME/profile
+   - Ve a la sección "Two-Factor Authentication"
+   - Elige "Authorization and Publishing" o "Authorization only"
+   - Escanea el código QR con una app como Google Authenticator o Authy
+
+2. **Publica con código 2FA:**
+   ```bash
+   npm publish --otp=123456
+   ```
+   (Reemplaza 123456 con el código de tu app de autenticación)
+
+### Opción 2: Usar un Access Token con permisos especiales
+
+1. **Crear un token de automatización:**
+   - Ve a: https://www.npmjs.com/settings/YOUR_USERNAME/tokens
+   - Click en "Generate New Token"
+   - Selecciona "Automation" (este tipo puede publicar sin 2FA)
+   - Copia el token generado
+
+2. **Configurar el token localmente:**
+   ```bash
+   npm logout
+   npm login
+   # En "Username": Deja el campo vacío y presiona Enter
+   # En "Password": Pega tu token
+   # En "Email": Tu email de NPM
+   ```
+
+3. **O configurar directamente en .npmrc:**
+   ```bash
+   npm config set //registry.npmjs.org/:_authToken YOUR_TOKEN_HERE
+   ```
+
+## Pasos Completos para Publicar
+
+### 1. Verificar login
+```bash
+npm whoami
+```
+
+### 2. Verificar que el paquete esté listo
+```bash
+npm run build
+npm pack --dry-run
+```
+
+### 3. Publicar
+
+**Con 2FA habilitado:**
+```bash
+npm publish --access public --otp=123456
+```
+
+**Con token de automatización:**
+```bash
+npm publish --access public
+```
+
+## Alternativa: Cambiar el nombre del paquete
+
+Si "codecrypto-cli" ya está ocupado o quieres usar un nombre único:
+
+1. **Edita package.json:**
+   ```json
+   {
+     "name": "@tu-usuario/codecrypto-cli",
+     ...
+   }
+   ```
+
+2. **Publica con scope:**
+   ```bash
+   npm publish --access public
+   ```
+
+3. **Los usuarios lo usarán así:**
+   ```bash
+   npx @tu-usuario/codecrypto-cli --help
+   ```
+
+## Verificar después de publicar
+
+```bash
+# Ver en NPM
+open https://www.npmjs.com/package/codecrypto-cli
+
+# Probar instalación
+npx codecrypto-cli@latest --help
+
+# Ver información del paquete
+npm view codecrypto-cli
+```
+
+## Actualizar versiones futuras
+
+```bash
+# Incrementar versión
+npm version patch   # 1.0.0 -> 1.0.1
+npm version minor   # 1.0.0 -> 1.1.0
+npm version major   # 1.0.0 -> 2.0.0
+
+# Publicar nueva versión (con 2FA)
+npm publish --otp=123456
+```
+
+## Troubleshooting
+
+### Error: "You must verify your email"
+```bash
+# Revisa tu correo y verifica la cuenta NPM
+```
+
+### Error: "Package name already exists"
+```bash
+# Cambia el nombre en package.json a algo único
+# O usa un scoped package: @tu-usuario/nombre
+```
+
+### Error: "Invalid token"
+```bash
+# Logout y login de nuevo
+npm logout
+npm login
+```
+
+### Ver logs completos de errores
+```bash
+cat ~/.npm/_logs/*-debug-0.log
+```
+
+## Recomendación
+
+Para uso profesional, usa **Opción 1 (2FA)** por seguridad. Guarda los códigos de respaldo en un lugar seguro.
+
+## Comandos Rápidos
+
+```bash
+# Setup completo
+npm login                              # Login
+npm whoami                             # Verificar usuario
+npm run build                          # Compilar
+npm publish --access public --otp=CODE # Publicar con 2FA
+
+# Verificar
+npx codecrypto-cli --help             # Probar
+npm view codecrypto-cli                # Ver info
+```

package/README.md

@@ -0,0 +1,551 @@
+# CodeCrypto CLI
+
+CLI tool for CodeCrypto operations - Deploy, manage users, configure settings, and handle database operations.
+
+## Instalación
+
+### Usando NPX (sin instalación)
+```bash
+npx codecrypto-cli [command]
+```
+
+### Instalación Global
+```bash
+npm install -g codecrypto-cli
+codecrypto [command]
+```
+
+### Instalación Local (desarrollo)
+```bash
+git clone <repository>
+cd cli-cc
+npm install
+npm run build
+npm link
+```
+
+## Comandos Disponibles
+
+### 📦 Deploy
+
+Despliega tu aplicación en diferentes entornos.
+
+```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
+```
+
+**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
+```
+
+---
+
+### 👤 User
+
+Gestiona usuarios en el sistema.
+
+#### Crear Usuario
+
+```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
+```
+
+**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
+
+---
+
+### ⚙️ 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
+
+**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
+```
+
+#### List (Listar configuración)
+
+```bash
+# Configuración local
+codecrypto config list
+
+# Configuración global
+codecrypto config list --global
+```
+
+**Opciones:**
+- `-g, --global` - Mostrar configuración global
+
+---
+
+### 💾 Database (db)
+
+Operaciones de base de datos.
+
+#### Migraciones
+
+```bash
+# Ejecutar migraciones
+codecrypto db migrate
+
+# Ejecutar en producción
+codecrypto db migrate -e prod
+
+# Rollback última migración
+codecrypto db migrate --rollback
+
+# Rollback 3 migraciones
+codecrypto db migrate --rollback --steps 3
+```
+
+**Opciones:**
+- `-e, --env <environment>` - Entorno. Default: `dev`
+- `--rollback` - Revertir migración
+- `--steps <number>` - Número de migraciones. Default: `all`
+
+#### Seed (Poblar datos)
+
+```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
+
+#### Backup
+
+```bash
+# Crear backup
+codecrypto db backup my-backup
+
+# Backup de producción
+codecrypto db backup prod-backup -e prod
+
+# Backup sin comprimir
+codecrypto db backup test-backup --compress false
+
+# Especificar directorio
+codecrypto db backup daily-backup -o /backups/daily
+```
+
+**Opciones:**
+- `-e, --env <environment>` - Entorno origen. Default: `prod`
+- `-o, --output <path>` - Directorio de salida. Default: `./backups`
+- `--compress` - Comprimir archivo. Default: `true`
+
+#### Restore
+
+```bash
+# Restaurar en dev
+codecrypto db restore backup_2024-01-15.sql.gz
+
+# Restaurar en staging
+codecrypto db restore backup.sql -e staging
+
+# Restaurar en prod (requiere --force)
+codecrypto db restore backup.sql -e prod --force
+```
+
+**Opciones:**
+- `-e, --env <environment>` - Entorno destino. Default: `dev`
+- `--force` - Omitir confirmación (requerido para prod)
+
+---
+
+## Ayuda
+
+```bash
+# Ayuda general
+codecrypto --help
+
+# Ayuda de comando específico
+codecrypto deploy --help
+codecrypto user --help
+codecrypto user create --help
+codecrypto db --help
+codecrypto db migrate --help
+```
+
+## Ejemplos de Uso 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
+
+# 2. Ejecutar migraciones
+codecrypto db migrate -e staging
+
+# 3. Deploy a staging
+codecrypto deploy -e staging -b develop
+
+# 4. Si todo OK, deploy a producción
+codecrypto deploy -e prod -b main
+```
+
+### 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
+```
+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
+├── dist/                     # Build output
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+### Scripts de Desarrollo
+
+```bash
+# Instalar dependencias
+npm install
+
+# Desarrollo (ejecutar sin compilar)
+npm run dev -- deploy --help
+
+# Compilar
+npm run build
+
+# Probar compilado
+npm run test
+
+# Testear localmente con npm link
+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
+```
+
+### 2. Actualizar package.json
+
+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)
+
+```json
+{
+  "name": "codecrypto-cli",
+  "version": "1.0.0",
+  "files": ["dist", "README.md"],
+  ...
+}
+```
+
+### 3. Verificar el nombre
+
+```bash
+# Verificar si el nombre está disponible
+npm search codecrypto-cli
+```
+
+Si está ocupado, cambia el nombre en `package.json`:
+```json
+{
+  "name": "@tu-usuario/codecrypto-cli"
+}
+```
+
+### 4. Build Final
+
+```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
+
+```bash
+# Probar instalación
+npx codecrypto-cli@latest --help
+
+# O con el nombre real de tu paquete
+npx tu-paquete --help
+```
+
+### 8. Actualizar Versiones
+
+Cuando hagas cambios:
+
+```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
+
+# Publicar nueva versión
+npm publish
+```
+
+### Workflow Completo de Publicación
+
+```bash
+# 1. Asegurarte que todo funciona
+npm run build
+npm run test
+
+# 2. Login a NPM
+npm login
+
+# 3. Verificar nombre disponible
+npm search codecrypto-cli
+
+# 4. Publicar
+npm publish --access public
+
+# 5. Verificar
+npx codecrypto-cli --help
+
+# 6. Para actualizaciones futuras
+npm version patch
+npm publish
+```
+
+### Despublicar (si es necesario)
+
+```bash
+# Solo dentro de las primeras 72 horas
+npm unpublish codecrypto-cli@1.0.0
+
+# Despublicar todas las versiones (usar con cuidado)
+npm unpublish codecrypto-cli --force
+```
+
+## 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
+
+5. **Git Tags**: Crea tags para cada versión
+   ```bash
+   git tag v1.0.0
+   git push --tags
+   ```
+
+## Troubleshooting
+
+### 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`
+
+### Error: "permission denied"
+```bash
+# Linux/Mac
+chmod +x dist/index.js
+```
+
+### 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
+
+MIT

package/dist/commands/config.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const configCommand: Command;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,aAAa,SACgB,CAAC"}