Merge: sync local with remote, keeping local changes

Author: mkt-inge3d

.claude/settings.local.json

@@ -0,0 +1,30 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pnpm install)",
+      "Bash(npm install:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(pnpm run build:*)",
+      "Bash(npm run build:*)",
+      "Bash(export PATH=\"$HOME/.local/share/pnpm:$PATH\")",
+      "Bash(npm run db:generate:*)",
+      "Bash(npx tsc:*)",
+      "Bash(ls:*)",
+      "Bash(bun add:*)",
+      "Bash(npm cache clean:*)",
+      "Bash(grep:*)",
+      "Bash(bun run build:*)",
+      "Bash(xargs cat:*)",
+      "Bash(find:*)",
+      "Bash(corepack enable:*)",
+      "Bash(npx pnpm install)",
+      "Bash(psql:*)",
+      "Bash(lsof:*)",
+      "Bash(ss:*)",
+      "Bash(curl:*)",
+      "Bash(pgrep:*)",
+      "Bash(npx tsx:*)"
+    ]
+  }
+}

.dockerignore

@@ -0,0 +1,70 @@
+# Dependencies
+node_modules
+npm-debug.log
+yarn-error.log
+pnpm-debug.log
+
+# Testing
+coverage
+.nyc_output
+
+# Next.js
+.next
+out
+
+# Production
+dist
+build
+
+# Misc
+.DS_Store
+*.pem
+
+# Debug
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Local env files
+.env
+.env*.local
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# IDEs
+.vscode
+.idea
+*.swp
+*.swo
+*~
+
+# Git
+.git
+.gitignore
+.gitattributes
+
+# CI/CD
+.github
+.gitlab-ci.yml
+
+# Documentation
+*.md
+!README.md
+
+# Kubernetes
+kubernetes
+
+# Docker
+Dockerfile
+.dockerignore
+docker-compose*.yml
+
+# Drizzle
+drizzle
+
+# WhatsApp sessions (will be mounted as volume)
+whatsapp_sessions
+
+# Media files (will be mounted as volume)
+public/media

.github/workflows/docker-publish.yml

@@ -0,0 +1,45 @@
+name: Build and Publish Docker Image
+
+on:
+  push:
+    branches:
+      - master
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: darwinva97/wapi
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Log in to Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=raw,value=latest
+            type=sha,prefix=
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

.npmrc

@@ -0,0 +1,3 @@
+# pnpm configuration
+shamefully-hoist=true
+strict-peer-dependencies=false

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "editor.tabSize": 2
+}

CHANGELOG.md

@@ -0,0 +1,175 @@
+# Changelog
+
+Todos los cambios notables de este proyecto serán documentados en este archivo.
+
+El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.0.0/).
+
+---
+
+## [Unreleased] - Próximas Características
+
+### 🎯 Planeado
+
+#### Receiver Filter Avanzado
+Actualmente el `receiverFilter` solo soporta filtros JSON estáticos. Se planea extender esta funcionalidad:
+
+- **Evaluación de JavaScript**: Permitir escribir código JavaScript que evalúe el mensaje entrante y retorne `true`/`false` para decidir si el webhook se dispara.
+  ```javascript
+  // Ejemplo: solo mensajes que contengan "pedido" y no sean míos
+  (msg) => !msg.key.fromMe && msg.message?.conversation?.includes("pedido")
+  ```
+
+- **Plantillas de Petición HTTP**: Configurar una petición HTTP que se evalúe antes de enviar el webhook. Si la respuesta es truthy (status 2xx, body "true", etc.), el mensaje pasa.
+  ```json
+  {
+    "type": "http",
+    "url": "https://mi-api.com/should-forward",
+    "method": "POST",
+    "body": "{{message}}",
+    "expectStatus": 200
+  }
+  ```
+
+#### Más Ideas para el Roadmap
+
+- **🖼️ Visualización de Media en Chats**
+  - Ver imágenes, videos y stickers directamente en el chat del dashboard
+  - Previews de documentos y audios
+  - Galería de media por conversación
+  - Descarga de archivos multimedia
+
+- **📖 Documentación del Software**
+  - Documentación técnica de la arquitectura
+  - Guías de uso para usuarios finales
+  - API Reference con OpenAPI/Swagger
+  - Ejemplos de integración (n8n, Make, código)
+  - Documentación inline con JSDoc/TSDoc
+
+- **🔐 Sistema de Roles y Permisos (RBAC+)**
+  
+  Sistema de control de acceso basado en roles con permisos granulares. Los roles funcionan como **plantillas de permisos mínimos** que pueden extenderse con permisos adicionales por usuario.
+
+  **Contextos de Permisos:**
+  
+  | Contexto | Descripción | Ejemplo |
+  |----------|-------------|---------|
+  | `system` | Permisos globales del sistema | Crear usuarios, ver métricas globales |
+  | `whatsapp:{id}` | Permisos sobre un WhatsApp específico | Gestionar conexiones, ver chats |
+
+  **Roles Predefinidos:**
+
+  | Rol | Scope | Descripción |
+  |-----|-------|-------------|
+  | `owner` | Sistema | Control total. Puede todo. |
+  | `admin` | Sistema | Puede crear/gestionar WhatsApps y usuarios |
+  | `manager` | WhatsApp | Gestiona conexiones de un WhatsApp asignado |
+  | `user` | WhatsApp | Acceso de solo lectura a chats asignados |
+
+  **Permisos Granulares (Resources + Actions):**
+
+  ```
+  # Formato: resource:action
+  
+  # Sistema
+  system:users:create
+  system:users:read
+  system:users:update
+  system:users:delete
+  system:whatsapps:create
+  system:metrics:read
+  
+  # WhatsApp específico
+  whatsapp:read
+  whatsapp:update
+  whatsapp:delete
+  whatsapp:connections:create
+  whatsapp:connections:read
+  whatsapp:connections:update
+  whatsapp:connections:delete
+  whatsapp:chats:read
+  whatsapp:chats:send
+  whatsapp:contacts:read
+  whatsapp:groups:read
+  ```
+
+  **Permisos de Recursos Específicos:**
+  
+  Además de los permisos por tipo, se pueden asignar permisos a recursos específicos:
+  ```
+  whatsapp:chats:read:*                    # Todos los chats
+  whatsapp:chats:read:group:123456@g.us    # Solo este grupo
+  whatsapp:chats:read:contact:519999@s.whatsapp.net  # Solo este contacto
+  ```
+
+  **Herencia de Roles:**
+  ```
+  owner   → admin + system:*
+  admin   → manager + system:users:* + system:whatsapps:create
+  manager → user + whatsapp:connections:* + whatsapp:chats:send
+  user    → whatsapp:chats:read + whatsapp:contacts:read
+  ```
+
+  **Asignación de Permisos:**
+  - Rol base (plantilla mínima)
+  - Permisos adicionales por usuario
+  - Permisos por contexto (sistema o WhatsApp específico)
+  - Restricciones a recursos específicos (chats, grupos, contactos)
+
+- **📊 Métricas y Estadísticas**
+  - Logs de webhooks (exitosos/fallidos)
+  - Tiempo de respuesta de webhooks
+
+- **🔗 Transformadores de Payload**
+  - Transformar el payload del webhook antes de enviarlo
+  - Mapear campos a formato personalizado
+  - Filtrar campos sensibles
+
+- **⏰ Programación de Mensajes**
+  - Enviar mensajes programados
+  - Campañas de mensajes masivos
+  - Rate limiting inteligente
+
+- **🏷️ Etiquetas y Categorías**
+  - Etiquetar conversaciones
+  - Filtrar mensajes por etiquetas
+  - Asignar conversaciones a usuarios
+
+- **🔐 Seguridad Avanzada**
+  - IP whitelist para webhooks
+  - Rate limiting por conexión/token
+
+- **📱 Multi-dispositivo**
+  - Sincronización entre múltiples instancias
+  - Failover automático
+
+- **🤖 Integraciones**
+  - Integración nativa con n8n
+  - Integración con Zapier
+  - SDK para Node.js/Python
+
+- **💬 Respuestas Automáticas**
+  - Autoresponder configurable
+  - Horarios de atención
+  - Mensajes de ausencia
+
+---
+
+## [0.1.0] - 2026-01-05
+
+### Añadido
+- 📱 Gestión de múltiples cuentas WhatsApp via QR
+- 🔗 Sistema de conexiones (integraciones) bidireccionales
+- 📤 Sender API para envío de mensajes
+- 📥 Receiver webhooks para mensajes entrantes
+- 👥 Gestión de contactos y grupos
+- 💬 Chat en tiempo real con SSE
+- 🔐 Autenticación con Better Auth
+- 👤 Roles de usuario (admin/user)
+- 📊 Dashboard de administración
+
+### Stack
+- Next.js 16 (App Router)
+- SQLite/Turso con Drizzle ORM
+- Baileys para WhatsApp
+- Better Auth
+- Tailwind CSS + shadcn/ui