Marketplace

El Marketplace de Keirost es el lugar donde encontrar plugins creados por la comunidad.

Instalar un plugin

Desde el CLI

# Buscar plugins
openfactu plugin search facturacion

# Instalar
openfactu plugin install nombre-del-plugin

Manual

# Clonar el repo del plugin en la carpeta de plugins
git clone https://github.com/autor/mi-plugin.git plugins/mi-plugin

# Reiniciar el servidor
docker compose restart server

El plugin se cargara automáticamente al arrancar.

Publicar tu plugin

Para que tu plugin aparezca en el marketplace:

1. Crea un repositorio en GitHub con tu plugin
2. Asegurate de que tiene la estructura correcta (ver el tutorial paso a paso)
3. Añade el topic openfactu-plugin al repositorio
4. Tu plugin aparecera automáticamente en el marketplace

Checklist antes de publicar

• index.ts exporta init() y el manifest.json valida contra PluginManifest
• name y version coherentes entre package.json y manifest.json
• README.md cuidado: es la descripción que se muestra en la ficha del plugin
• Repositorio publico con el topic openfactu-plugin
• Probado contra un servidor real (ver tutorial parte 6)

Topics recomendados

Además de openfactu-plugin (obligatorio), añade topics descriptivos:

• facturacion, inventario, contabilidad — por funcionalidad
• integracion, api, webhook — por tipo
• El marketplace los muestra como tags en la card del plugin

Versionado

El marketplace sincroniza tu repositorio de GitHub y registra las versiones publicadas (con su changelog y compatibilidad) en su propia base de datos. Usa releases de GitHub con versionado semántico (v1.0.0, v1.1.0…) para que cada versión quede registrada con sus notas.

El campo version del manifest.json es la versión del propio plugin; el manifest no declara versión mínima de Keirost — la compatibilidad se gestiona desde el marketplace.

API del marketplace

GET  /api/marketplace/plugins              # Lista todos los plugins
GET  /api/marketplace/plugins/:id          # Detalle con versiones y reviews
GET  /api/marketplace/plugins/:id/download # Descargar (incrementa contador)
POST /api/marketplace/sync                 # Sincronizar con GitHub