@soccagency/sh 0.2.0

package/README.md

@@ -0,0 +1,242 @@
+# Socc CLI
+
+CLI para subir proyectos a Socc y obtener preview links instantáneos.
+
+## 🛠️ Stack
+
+- **Runtime:** Node.js 20+
+- **Package:** npm
+- **Comprimiendo:** archiver
+- **HTTP:** undici (fetch nativo)
+
+## 📋 Requisitos
+
+- Node.js 20+
+- npm o yarn
+- Token de Socc (obtenido desde sh.socc.ink)
+
+## 🚀 Instalación
+
+### Desde npm (cuando esté publicado)
+
+```bash
+npm install -g @socc/sh
+```
+
+### Desde código fuente
+
+```bash
+# Clonar o navegar al directorio del CLI
+cd /home/clawdbot/projects/socc/cli
+
+# Instalar dependencias
+npm install
+
+# Instalar globalmente (desarrollo)
+npm install -g .
+```
+
+## 🔧 Comandos
+
+### `socc login <token>`
+
+Inicia sesión con tu API token.
+
+```bash
+socc login socc_cw5MIU0haehbgAJma3vw4pXUqENHu8vj
+```
+
+**Obtener tu token:**
+
+1. Andá a https://sh.socc.ink
+2. Logueate con GitHub
+3. Click en tu avatar → Settings
+4. Click en "Generar API Token"
+5. Copiá el token
+
+### `socc link [--ttl <horas>] [--framework <name>]`
+
+Sube tu proyecto actual y crea un preview link.
+
+```bash
+cd mi-proyecto
+socc link
+socc link --ttl 1
+socc link --framework vite
+```
+
+**Output:**
+```
+🚀 Socc - Deploy instantáneo
+
+🔐 Verificando tu cuenta...
+✅ Autenticado como: tu@email.com
+📊 Plan: FREE
+📈 Deployments activos: 0/1
+📅 Deployments hoy: 0/5
+📦 Framework usado: static
+⏰ TTL solicitado: 1 hora(s)
+📦 Comprimiendo archivos...
+✅ Archivos comprimidos
+📤 Subiendo a Socc...
+✅ Uploaded emqg9i7y/deploy.zip to R2 (0.00 MB)
+✅ Extracted 3 files to R2
+
+✅ ¡Deploy exitoso!
+
+🚀 Tu preview está en: https://emqg9i7y.socc.ink
+⏰ Expira en: 6 horas
+```
+
+### `socc list`
+
+Lista tus deployments activos.
+
+```bash
+socc list
+```
+
+**Output:**
+```
+📋 Obteniendo tus deployments...
+
+📦 Tus deployments (2):
+
+  1. 🟢 emqg9i7y
+     URL: https://emqg9i7y.socc.ink
+     Framework: static
+     Tamaño: 0.01 MB
+     Expira en: 5h
+
+  2. 🟢 xQ39GogI
+     URL: https://xQ39GogI.socc.ink
+     Framework: react
+     Tamaño: 1.23 MB
+     Expira en: 23h
+```
+
+### `socc delete <id>`
+
+Elimina un deployment.
+
+```bash
+socc delete emqg9i7y
+```
+
+**Output:**
+```
+🗑️  Borrando deployment emqg9i7y...
+✅ Deployment emqg9i7y eliminado.
+```
+
+### `socc whoami`
+
+Muestra información de tu cuenta.
+
+```bash
+socc whoami
+```
+
+**Output:**
+```
+👤 Usuario: tu@email.com
+📊 Plan: FREE
+📈 Deployments activos: 0/1
+📅 Deployments hoy: 2/5
+📦 Total links: 15
+```
+
+## 📦 Frameworks Detectados
+
+La CLI detecta automáticamente el framework y configura el build.
+También detecta package manager (`npm`, `yarn`, `pnpm`, `bun`) por lockfile:
+
+| Framework | Detecta | Build | Output |
+|-----------|---------|-------|--------|
+| **Vite** | `vite.config.js` | `npm run build` | `dist/` |
+| **React (CRA)** | `package.json` + react-scripts | `npm run build` | `build/` |
+| **Next.js** | `next.config.js` | `npm run build` | `out/` (static) |
+| **Angular** | `angular.json` | `ng build` | `dist/` |
+| **Astro** | `astro.config.*` o dependencia `astro` | `build` | `dist/` |
+| **Static** | Por defecto | - | `.` |
+| **Custom build** | `scripts.build` sin framework conocido | `build` | `dist/`, `build/` u `out/` |
+
+Frameworks válidos para `--framework`:
+
+`auto`, `vite`, `react`, `next`, `angular`, `nuxt`, `static`
+
+> Para Next.js, Socc exige export estático (`out/`).  
+> Configurá `output: "export"` en `next.config.js`.
+
+## 🔍 Cómo funciona
+
+1. **Detecta el framework** buscando archivos de configuración
+2. **Ejecuta el build** si es necesario
+3. **Comprime** el output en un ZIP
+4. **Envía** el ZIP a la API (`POST /api/link`)
+5. **API** extrae y sube archivos a R2
+6. **Recibe** la URL del preview
+
+## 🐛 Troubleshooting
+
+### Error: "No estás autenticado"
+
+```bash
+socc login <tu-token>
+```
+
+### Error: "Token inválido o expirado"
+
+- El token puede haber sido revocado
+- Generá uno nuevo en Settings
+
+### Error: "Llegaste al límite diario"
+
+- Tu plan tiene un límite de links por día
+- Esperá al próximo día o actualizá tu plan
+
+### Error: "Build fallido"
+
+- Verificá que el proyecto compila localmente
+- Revisá que tenés las dependencias instaladas
+
+### Error: "File too large"
+
+- Tu plan tiene un límite de upload
+- Free: 10 MB, Starter: 50 MB, Pro: 100 MB
+
+## 📝 Configuración
+
+El CLI guarda tu token en:
+
+```
+~/.socc/config.json
+```
+
+Contenido:
+```json
+{
+  "token": "socc_cw5MIU0haehbgAJma3vw4pXUqENHu8vj"
+}
+```
+
+También podés cambiar la API con variable de entorno:
+
+```bash
+SOCC_API_URL=http://localhost:3000 socc whoami
+```
+
+## 🚀 Publicar en npm
+
+```bash
+# Publicar versión actual (ej: 0.2.0)
+npm whoami
+npm publish
+
+# Verificar paquete antes de publicar
+npm run pack:check
+```
+
+---
+
+[Volver al README principal](../README.md)

package/bin/socc.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../src/index.js';

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@soccagency/sh",
+  "version": "0.2.0",
+  "description": "Instant preview links for your projects",
+  "main": "src/index.js",
+  "bin": {
+    "socc": "bin/socc.js"
+  },
+  "type": "module",
+  "scripts": {
+    "pack:check": "npm pack --dry-run"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "keywords": [
+    "deploy",
+    "preview",
+    "hosting",
+    "cli",
+    "tunnel"
+  ],
+  "author": "Socc Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GuilleG25/socc.git",
+    "directory": "cli"
+  },
+  "homepage": "https://sh.socc.ink",
+  "bugs": {
+    "url": "https://github.com/GuilleG25/socc/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "archiver": "^7.0.1",
+    "undici": "^7.22.0"
+  }
+}

package/src/index.js

@@ -0,0 +1,689 @@
+#!/usr/bin/env node
+
+import { execSync } from 'child_process';
+import { readFileSync, writeFileSync, existsSync, unlinkSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { createWriteStream } from 'fs';
+import archiver from 'archiver';
+import { fetch } from 'undici';
+
+const API_URL = process.env.SOCC_API_URL || 'https://api.socc.ink';
+
+const ALLOWED_FRAMEWORKS = ['auto', 'vite', 'react', 'next', 'angular', 'nuxt', 'astro', 'static'];
+
+const FRAMEWORK_CONFIGS = {
+  vite: { name: 'vite', buildScript: 'build', distCandidates: ['dist'] },
+  react: { name: 'react', buildScript: 'build', distCandidates: ['build'] },
+  next: { name: 'next', buildScript: 'build', distCandidates: ['out'] },
+  angular: { name: 'angular', buildScript: 'build', distCandidates: ['dist'] },
+  nuxt: { name: 'nuxt', buildScript: 'generate', distCandidates: ['dist'] },
+  astro: { name: 'astro', buildScript: 'build', distCandidates: ['dist'] },
+  static: { name: 'static', buildScript: null, distCandidates: ['dist', '.'] }
+};
+
+// Colores
+const colors = {
+  reset: '\x1b[0m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m',
+  white: '\x1b[37m'
+};
+
+function log(msg, color = 'reset') {
+  console.log(`${colors[color]}${msg}${colors.reset}`);
+}
+
+// ============= COMANDOS =============
+
+function showHelp() {
+  log(`
+🚀 Socc CLI - Deploy instantáneo
+
+Uso:
+  socc                                Mostrar esta ayuda
+  socc link [--ttl <horas>] [--framework <${ALLOWED_FRAMEWORKS.join('|')}>]
+  socc list                           Listar tus deployments
+  socc delete <id>                    Borrar un deployment
+  socc login <token>                  Iniciar sesión con API token
+  socc whoami                         Ver info de tu cuenta
+  socc help                           Mostrar esta ayuda
+
+Flags de socc link:
+  --ttl <horas>        TTL en horas (entero positivo, por defecto 6)
+  --framework <name>   Fuerza framework: auto|vite|react|next|angular|nuxt|astro|static
+
+Variables de entorno:
+  SOCC_API_URL         API base URL (default: https://api.socc.ink)
+
+Ejemplos:
+  $ socc login socc_abcdef123...
+  $ socc link --ttl 1
+  $ socc link --framework vite
+  $ SOCC_API_URL=http://localhost:3000 socc whoami
+
+Planes:
+  Free       - 1 deployment activo, 5/día, 10MB max
+  Starter    - 5 deployments activos, 50/día, 50MB max
+  Pro        - 20 deployments activos, 200/día, 100MB max
+  Enterprise - Ilimitado
+`, 'cyan');
+}
+
+async function cmdLogin(args) {
+  const token = args[0];
+
+  if (!token) {
+    log('\n🔐 Socc Login\n', 'cyan');
+    log('Uso: socc login <tu-api-token>\n', 'white');
+    log('📋 Cómo obtener tu API token:', 'yellow');
+    log('1. Andá a https://sh.socc.ink y logueate con GitHub', 'yellow');
+    log('2. Hacé click en tu avatar → Settings', 'yellow');
+    log('3. Click en "Generar API Token"', 'yellow');
+    log('4. Copiá el token y ejecutá: socc login socc_xxxxx\n', 'yellow');
+    process.exit(0);
+  }
+
+  log('🔐 Verificando token...', 'yellow');
+  const userInfo = await getUserInfo(token);
+
+  if (!userInfo.success) {
+    log(`❌ Token inválido: ${userInfo.error}`, 'red');
+    process.exit(1);
+  }
+
+  // Guardar token
+  const configDir = join(process.env.HOME, '.socc');
+  const configPath = join(configDir, 'config.json');
+
+  if (!existsSync(configDir)) {
+    mkdirSync(configDir, { recursive: true });
+  }
+
+  writeFileSync(configPath, JSON.stringify({ token }, null, 2));
+
+  log('✅ ¡Login exitoso!', 'green');
+  log(`\n👤 Autenticado como: ${userInfo.user.email}`, 'white');
+  log(`📊 Plan: ${userInfo.user.tier.toUpperCase()}`, 'blue');
+  log('\n🚀 Ahora podés usar: socc link\n', 'cyan');
+}
+
+async function cmdWhoami() {
+  const token = getToken();
+
+  if (!token) {
+    log('❌ No estás autenticado. Corré `socc login` primero.', 'red');
+    process.exit(1);
+  }
+
+  const userInfo = await getUserInfo(token);
+
+  if (!userInfo.success) {
+    log(`❌ Error: ${userInfo.error}`, 'red');
+    process.exit(1);
+  }
+
+  const { user, usage } = userInfo;
+
+  log('\n👤 Tu cuenta Socc\n', 'cyan');
+  log(`Email: ${user.email}`, 'white');
+  log(`Plan: ${user.tier.toUpperCase()}`, 'blue');
+  log(`Estado: ${user.subscriptionStatus || 'active'}`, 'green');
+  log('\n📊 Uso:', 'yellow');
+  log(`  Deployments activos: ${usage.activeDeployments}/${usage.maxActiveDeployments}`, 'white');
+  log(`  Deployments hoy: ${usage.linksToday}/${usage.linksLimit}`, 'white');
+  log(`  Max upload: ${usage.maxUpload}`, 'white');
+  log(`  Max TTL: ${usage.maxTtl}`, 'white');
+  log(`\n📈 Total deployments: ${usage.totalLinks}\n`, 'gray');
+}
+
+async function cmdList() {
+  const token = getToken();
+
+  if (!token) {
+    log('❌ No estás autenticado. Corré `socc login` primero.', 'red');
+    process.exit(1);
+  }
+
+  log('📋 Obteniendo tus deployments...', 'yellow');
+
+  try {
+    const response = await fetch(`${API_URL}/api/list`, {
+      headers: { Authorization: `Bearer ${token}` }
+    });
+
+    const data = await response.json();
+
+    if (!data.success) {
+      log(`❌ Error: ${data.error}`, 'red');
+      process.exit(1);
+    }
+
+    if (data.deployments.length === 0) {
+      log('\n📭 No tenés deployments activos.', 'gray');
+      log('Creá tu primer deploy con: socc link\n', 'cyan');
+      return;
+    }
+
+    log('\n📦 Tus deployments:', 'cyan');
+
+    data.deployments.forEach((d, i) => {
+      const expires = new Date(d.expiresAt);
+      const now = new Date();
+      const hoursLeft = Math.round((expires - now) / (1000 * 60 * 60));
+      const status = hoursLeft > 0 ? '🟢' : '🔴';
+      const id = d.id || d.projectId || 'unknown';
+      const subdomain = d.subdomain || id;
+      const framework = d.framework || 'static';
+      const sizeMB = d.fileSize ? (d.fileSize / 1024 / 1024).toFixed(2) : '0.00';
+
+      console.log(`  ${i + 1}. ${status} ${id}`);
+      console.log(`     URL: https://${subdomain}.socc.ink`);
+      console.log(`     Framework: ${framework}`);
+      console.log(`     Tamaño: ${sizeMB} MB`);
+      console.log(`     Expira en: ${hoursLeft > 0 ? `${hoursLeft}h` : 'EXPIRADO'}`);
+      console.log('');
+    });
+
+  } catch (error) {
+    log(`❌ Error: ${error.message}`, 'red');
+    process.exit(1);
+  }
+}
+
+async function cmdDelete(args) {
+  const projectId = args[0];
+
+  if (!projectId) {
+    log('\n❌ Debes especificar un ID de deployment', 'red');
+    log('\nUso: socc delete <project-id>\n', 'yellow');
+    log('Obtené el ID con: socc list\n', 'cyan');
+    process.exit(1);
+  }
+
+  const token = getToken();
+
+  if (!token) {
+    log('❌ No estás autenticado. Corré `socc login` primero.', 'red');
+    process.exit(1);
+  }
+
+  log(`🗑️  Borrando deployment ${projectId}...`, 'yellow');
+
+  try {
+    const response = await fetch(`${API_URL}/api/delete/${projectId}`, {
+      method: 'DELETE',
+      headers: { Authorization: `Bearer ${token}` }
+    });
+
+    const data = await response.json();
+
+    if (!data.success) {
+      log(`❌ Error: ${data.error}`, 'red');
+      process.exit(1);
+    }
+
+    log(`✅ Deployment ${projectId} eliminado.\n`, 'green');
+
+  } catch (error) {
+    log(`❌ Error: ${error.message}`, 'red');
+    process.exit(1);
+  }
+}
+
+async function cmdLink(args) {
+  const parsedOptions = parseLinkOptions(args);
+
+  if (!parsedOptions.ok) {
+    log(`❌ ${parsedOptions.error}`, 'red');
+    log(`\nUso: socc link [--ttl <horas>] [--framework <${ALLOWED_FRAMEWORKS.join('|')}>]\n`, 'yellow');
+    process.exit(1);
+  }
+
+  const options = parsedOptions.options;
+
+  log('🚀 Socc - Deploy instantáneo\n', 'cyan');
+
+  const token = getToken();
+
+  if (!token) {
+    log('❌ No estás autenticado. Corré `socc login` primero.', 'red');
+    log('\nPara loguearte: socc login socc_xxxxx\n', 'cyan');
+    process.exit(1);
+  }
+
+  // Verificar límites
+  log('🔐 Verificando tu cuenta...', 'yellow');
+  const userInfo = await getUserInfo(token);
+
+  if (!userInfo.success) {
+    log(`❌ Error: ${userInfo.error}`, 'red');
+    process.exit(1);
+  }
+
+  const { user, usage, canCreateLink } = userInfo;
+
+  log(`✅ Autenticado como: ${user.email}`, 'green');
+  log(`📊 Plan: ${user.tier.toUpperCase()}`, 'blue');
+  log(`📈 Deployments activos: ${usage.activeDeployments}/${usage.maxActiveDeployments}`, 'blue');
+  log(`📅 Deployments hoy: ${usage.linksToday}/${usage.linksLimit}`, 'blue');
+
+  if (!canCreateLink) {
+    log('\n❌ Llegaste al límite diario de deployments.', 'red');
+    log(`Tu plan (${user.tier}) permite ${usage.linksLimit} deployments por día.`, 'yellow');
+    log('Volvé mañana o actualizá tu plan.\n', 'yellow');
+    process.exit(1);
+  }
+
+  if (usage.activeDeployments >= usage.maxActiveDeployments && usage.maxActiveDeployments !== 'unlimited') {
+    log('\n❌ Llegaste al máximo de deployments activos.', 'red');
+    log(`Tu plan (${user.tier}) permite ${usage.maxActiveDeployments} deployments activos.`, 'yellow');
+    log('Eliminá previews viejos con: socc delete <id>', 'yellow');
+    log('O actualizá tu plan.\n', 'yellow');
+    process.exit(1);
+  }
+
+  // Detectar framework
+  const framework = detectFramework(options.framework);
+  const packageManager = detectPackageManager();
+  log(`📦 Framework usado: ${framework.name}`, 'blue');
+  log(`📦 Package manager detectado: ${packageManager}`, 'blue');
+  log(`⏰ TTL solicitado: ${options.ttl} hora(s)`, 'blue');
+
+  // Build
+  if (framework.buildScript) {
+    const buildCommand = buildCommandForScript(packageManager, framework.buildScript);
+    log(`🔨 Construyendo proyecto (${buildCommand})...`, 'yellow');
+    try {
+      execSync(buildCommand, { stdio: 'inherit' });
+      log('✅ Build completado', 'green');
+    } catch {
+      log('❌ Build fallido', 'red');
+      process.exit(1);
+    }
+  }
+
+  let distPath;
+  try {
+    distPath = resolveDistPath(framework);
+  } catch (error) {
+    log(`❌ ${error.message}`, 'red');
+    process.exit(1);
+  }
+
+  // Comprimir
+  log('📦 Comprimiendo archivos...', 'yellow');
+  const zipPath = await zipDirectory(distPath);
+  log('✅ Archivos comprimidos', 'green');
+
+  // Upload
+  log('📤 Subiendo a Socc...', 'yellow');
+  try {
+    const result = await uploadToApi(zipPath, token, {
+      ttl: options.ttl,
+      framework: framework.name
+    });
+
+    if (result.success && result.url) {
+      log('\n✅ ¡Deploy exitoso!', 'green');
+      log(`\n🚀 Tu preview está en: ${result.url}\n`, 'cyan');
+      log(`⏰ Expira en: ${result.ttl} horas\n`, 'blue');
+    } else {
+      log('❌ Error en el deploy', 'red');
+      if (result.error) {
+        log(result.error, 'red');
+      }
+      process.exit(1);
+    }
+  } catch (error) {
+    log(`❌ Error: ${error.message}`, 'red');
+    process.exit(1);
+  }
+
+  // Limpiar
+  try {
+    unlinkSync(zipPath);
+  } catch {
+    // ignore cleanup errors
+  }
+}
+
+// ============= HELPERS =============
+
+function getToken() {
+  const configPath = join(process.env.HOME, '.socc', 'config.json');
+  if (!existsSync(configPath)) {
+    return null;
+  }
+
+  try {
+    const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    return config.token;
+  } catch {
+    return null;
+  }
+}
+
+async function getUserInfo(token) {
+  try {
+    const response = await fetch(`${API_URL}/api/whoami`, {
+      headers: { Authorization: `Bearer ${token}` }
+    });
+
+    if (response.status === 401) {
+      return { success: false, error: 'Token inválido o expirado' };
+    }
+
+    const data = await response.json();
+
+    if (!data || !data.success) {
+      return { success: false, error: data?.error || 'Error al verificar usuario' };
+    }
+
+    return {
+      success: true,
+      user: data.user || {},
+      usage: data.usage || {},
+      limits: data.limits || {},
+      canCreateLink: data.canCreateLink !== false
+    };
+  } catch (error) {
+    return { success: false, error: error.message || 'Error de conexión' };
+  }
+}
+
+function parseLinkOptions(args) {
+  let ttl = 6;
+  let framework = 'auto';
+
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+
+    if (arg === '--ttl') {
+      const ttlValue = args[i + 1];
+      if (!ttlValue) {
+        return { ok: false, error: 'Falta valor para --ttl' };
+      }
+
+      const parsedTtl = Number.parseInt(ttlValue, 10);
+      if (!Number.isInteger(parsedTtl) || parsedTtl <= 0) {
+        return { ok: false, error: '--ttl debe ser un entero positivo' };
+      }
+
+      ttl = parsedTtl;
+      i += 1;
+      continue;
+    }
+
+    if (arg.startsWith('--ttl=')) {
+      const ttlValue = arg.split('=')[1];
+      const parsedTtl = Number.parseInt(ttlValue, 10);
+      if (!Number.isInteger(parsedTtl) || parsedTtl <= 0) {
+        return { ok: false, error: '--ttl debe ser un entero positivo' };
+      }
+
+      ttl = parsedTtl;
+      continue;
+    }
+
+    if (arg === '--framework') {
+      const frameworkValue = args[i + 1];
+      if (!frameworkValue) {
+        return { ok: false, error: 'Falta valor para --framework' };
+      }
+
+      if (!ALLOWED_FRAMEWORKS.includes(frameworkValue)) {
+        return { ok: false, error: `Framework inválido: ${frameworkValue}` };
+      }
+
+      framework = frameworkValue;
+      i += 1;
+      continue;
+    }
+
+    if (arg.startsWith('--framework=')) {
+      const frameworkValue = arg.split('=')[1];
+      if (!ALLOWED_FRAMEWORKS.includes(frameworkValue)) {
+        return { ok: false, error: `Framework inválido: ${frameworkValue}` };
+      }
+
+      framework = frameworkValue;
+      continue;
+    }
+
+    return { ok: false, error: `Flag no soportada: ${arg}` };
+  }
+
+  return {
+    ok: true,
+    options: {
+      ttl,
+      framework
+    }
+  };
+}
+
+function detectFramework(preferredFramework = 'auto') {
+  if (preferredFramework !== 'auto') {
+    return { ...FRAMEWORK_CONFIGS[preferredFramework] };
+  }
+
+  const pkgPath = join(process.cwd(), 'package.json');
+
+  if (!existsSync(pkgPath)) {
+    if (existsSync(join(process.cwd(), 'index.html'))) {
+      return { ...FRAMEWORK_CONFIGS.static, distCandidates: ['.'] };
+    }
+
+    log('❌ No se encontró package.json. Si es un sitio estático, incluí un index.html o usá --framework static.', 'red');
+    process.exit(1);
+  }
+
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+  const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+
+  if (deps.vite || hasAnyFile(['vite.config.js', 'vite.config.mjs', 'vite.config.ts', 'vite.config.cjs'])) {
+    return { ...FRAMEWORK_CONFIGS.vite };
+  }
+
+  if (deps.next || hasAnyFile(['next.config.js', 'next.config.mjs', 'next.config.ts'])) {
+    return { ...FRAMEWORK_CONFIGS.next };
+  }
+
+  if (deps['react-scripts']) {
+    return { ...FRAMEWORK_CONFIGS.react };
+  }
+
+  if (deps['@angular/core'] || existsSync(join(process.cwd(), 'angular.json'))) {
+    return { ...FRAMEWORK_CONFIGS.angular };
+  }
+
+  if (deps.nuxt || hasAnyFile(['nuxt.config.js', 'nuxt.config.ts'])) {
+    return { ...FRAMEWORK_CONFIGS.nuxt };
+  }
+
+  if (deps.astro || hasAnyFile(['astro.config.mjs', 'astro.config.js', 'astro.config.ts', 'astro.config.cjs'])) {
+    return { ...FRAMEWORK_CONFIGS.astro };
+  }
+
+  if (pkg.scripts?.build) {
+    return { name: 'custom', buildScript: 'build', distCandidates: ['dist', 'build', 'out'] };
+  }
+
+  const existingOutputDir = findFirstExistingDirectory(['dist', 'build', 'out']);
+  if (existingOutputDir) {
+    return { ...FRAMEWORK_CONFIGS.static, distCandidates: [existingOutputDir, '.'] };
+  }
+
+  if (existsSync(join(process.cwd(), 'index.html'))) {
+    return { ...FRAMEWORK_CONFIGS.static, distCandidates: ['.'] };
+  }
+
+  log('❌ No se pudo detectar framework ni directorio de salida. Usá --framework o creá script build.', 'red');
+  process.exit(1);
+}
+
+function hasAnyFile(fileNames) {
+  return fileNames.some((fileName) => existsSync(join(process.cwd(), fileName)));
+}
+
+function findFirstExistingDirectory(candidates) {
+  for (const candidate of candidates) {
+    if (existsSync(join(process.cwd(), candidate))) {
+      return candidate;
+    }
+  }
+
+  return null;
+}
+
+function detectPackageManager() {
+  if (existsSync(join(process.cwd(), 'bun.lockb')) || existsSync(join(process.cwd(), 'bun.lock'))) {
+    return 'bun';
+  }
+
+  if (existsSync(join(process.cwd(), 'pnpm-lock.yaml'))) {
+    return 'pnpm';
+  }
+
+  if (existsSync(join(process.cwd(), 'yarn.lock'))) {
+    return 'yarn';
+  }
+
+  if (existsSync(join(process.cwd(), 'package-lock.json'))) {
+    return 'npm';
+  }
+
+  return 'npm';
+}
+
+function buildCommandForScript(packageManager, scriptName) {
+  if (packageManager === 'yarn') {
+    return `yarn ${scriptName}`;
+  }
+
+  if (packageManager === 'pnpm') {
+    return `pnpm ${scriptName}`;
+  }
+
+  if (packageManager === 'bun') {
+    return `bun run ${scriptName}`;
+  }
+
+  return `npm run ${scriptName}`;
+}
+
+function resolveDistPath(framework) {
+  for (const candidate of framework.distCandidates) {
+    if (candidate === '.') {
+      if (existsSync(join(process.cwd(), 'index.html'))) {
+        return process.cwd();
+      }
+
+      continue;
+    }
+
+    const distPath = join(process.cwd(), candidate);
+
+    if (existsSync(distPath)) {
+      return distPath;
+    }
+  }
+
+  if (framework.name === 'next') {
+    throw new Error('No se encontró el directorio "out" de Next.js. Configurá `output: "export"` en next.config.js para export estático y volvé a ejecutar el build.');
+  }
+
+  if (framework.name === 'custom') {
+    throw new Error('Build ejecutado, pero no se encontró salida en dist/, build/ u out/. Forzá --framework o ajustá tu output.');
+  }
+
+  throw new Error(`No se encontró el directorio de salida (${framework.distCandidates.join(', ')})`);
+}
+
+async function zipDirectory(dirPath) {
+  const zipPath = join(process.cwd(), 'socc-deploy.zip');
+
+  return new Promise((resolve, reject) => {
+    const output = createWriteStream(zipPath);
+    const archive = archiver('zip', { zlib: { level: 9 } });
+
+    output.on('close', () => resolve(zipPath));
+    archive.on('error', reject);
+
+    archive.pipe(output);
+    archive.directory(dirPath, false, (entry) => {
+      if (
+        entry.name.includes('node_modules')
+        || entry.name.includes('.git')
+        || entry.name.includes('.next')
+        || entry.name === 'socc-deploy.zip'
+      ) {
+        return false;
+      }
+      return entry;
+    });
+
+    archive.finalize();
+  });
+}
+
+async function uploadToApi(zipPath, token, options) {
+  const fileBuffer = readFileSync(zipPath);
+
+  const response = await fetch(`${API_URL}/api/link`, {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${token}`,
+      'Content-Type': 'application/zip',
+      'X-TTL': `${options.ttl}`,
+      'X-Framework': options.framework
+    },
+    body: new Uint8Array(fileBuffer)
+  });
+
+  return response.json();
+}
+
+// ============= MAIN =============
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  switch (command) {
+    case undefined:
+    case 'help':
+    case '--help':
+    case '-h':
+      showHelp();
+      break;
+    case 'login':
+      await cmdLogin(args.slice(1));
+      break;
+    case 'whoami':
+      await cmdWhoami();
+      break;
+    case 'link':
+      await cmdLink(args.slice(1));
+      break;
+    case 'list':
+      await cmdList();
+      break;
+    case 'delete':
+      await cmdDelete(args.slice(1));
+      break;
+    default:
+      log(`❌ Comando desconocido: ${command}`, 'red');
+      log('Usá `socc help` para ver los comandos disponibles', 'yellow');
+      process.exit(1);
+  }
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});