Qué es un plugin

Un plugin de Hury Suite es un módulo opcional empaquetado como <clave>-<versión>.zip firmado. Se instala, se actualiza, vuelve a la versión anterior y se desinstala desde Ajustes → Módulos sin desplegar la aplicación. Un negocio que no lo instala no lleva su código, ni su migración, ni sus tablas.

Un plugin aporta, según lo necesite:

• API: rutas HTTP bajo /api/v1, trabajos en cola (jobs), tareas periódicas (schedules), reacciones a eventos de dominio y ganchos con valor de vuelta.
• Datos: migraciones SQL propias, aplicadas en su transacción y anotadas en plugin_migrations.
• Permisos: grupos propios que aparecen en la pantalla de roles.
• Panel: páginas Vue con el kit de interfaz del propio panel, entrada de menú, tutorial, traducciones y slots en pantallas del núcleo.

Cuándo sí y cuándo no

Es un plugin cuando:

• tiene entidad propia (tablas, rutas, pantalla de administración) y se puede apagar sin romper el resto;
• lo que necesita del núcleo se puede pedir con @host/… (API) o @/… (panel) o con ganchos;
• el núcleo (pos, crm, catalog, commerce, core, insights, posv3…) no lo importa directamente.

No lo es, y se queda integrado, cuando otro módulo del host lo importa o forma un ciclo con el núcleo. Dos plugins tampoco pueden depender uno del otro en ciclo: el cargador lo rechaza. Se rompe con un evento o un gancho, o se fusionan.

Qué necesitas

Para	Necesitas
Escribir y construir	Node.js 22 o superior y el kit de plugins (hury-plugin)
Firmar	Tu propio par de claves Ed25519 (generador o hury-plugin keygen)
Instalar	Que el dueño de la instalación acepte tu clave con PLUGIN_TRUSTED_KEYS (cómo), o subir el paquete firmado por Hury

Quién firma qué

Una instalación acepta por defecto solo la clave de Hury (PLUGIN_PUBLIC_KEY). Los plugins oficiales los firma Hury Studio offline: esa clave no sale del equipo del autor y no hay ninguna web que firme con ella.

Si desarrollas plugins propios, los firmas con tu clave y el dueño de la instalación la añade a PLUGIN_TRUSTED_KEYS en el servidor. Un plugin firmado con una clave de confianza se muestra como tal (Clave de confianza ab12cd34, con la huella de la clave), nunca como oficial, y no puede usar el catálogo privado de Hury. Ver Seguridad del desarrollador.

Por dónde seguir

1. Arquitectura: cómo se carga un plugin y qué contrato tiene con el host.
2. Mi primer plugin: la guía paso a paso.
3. Referencia y guía de diseño para consultar mientras escribes.