@hostwebhook/platform-contracts 0.20.0 → 0.21.0

package/dist/servicios/avisos-en-vivo.d.ts

@@ -19,7 +19,7 @@
  *
  * ## Lo que ya estaba bien
  *
- * Los diez métodos reciben datos planos, y no por casualidad: los llamantes
+ * Los métodos reciben datos planos, y no por casualidad: los llamantes
  * ya hacen `.toJSON()` o pasan por `comoObjetoPlano(...)` antes de emitir.
  * Aquí no hay ningún documento de Mongoose que aplanar — algo que en la
  * costura de ficheros costó un adaptador entero.
@@ -36,9 +36,9 @@
  * clase que en `discord.provider` también se llama `gateway`. Medir por el
  * TIPO inyectado y no por el nombre de la propiedad es lo que los descarta.
  *
- * ## ⚠️ Nueve avisan, uno CONTESTA
+ * ## ⚠️ Todos avisan menos uno, que CONTESTA
  *
- * Nueve de los diez son difusión a la sala `org:<id>`: se mandan y no se
+ * Todos menos uno son difusión a la sala `org:<id>`: se mandan y no se
  * espera nada. Si se pierde uno, el panel enseña un dato viejo hasta que
  * alguien recargue — molesto y nada más.
  *
@@ -49,8 +49,25 @@
  *
  * Va en el mismo contrato porque hoy es la misma inyección y su único
  * llamante es el motor, pero quien implemente esto por red tiene que tratarlo
- * distinto: los nueve pueden ser «dispara y olvida», éste no.
+ * distinto: los demás pueden ser «dispara y olvida», éste no.
  */
+/**
+ * Lo que dice el aviso de una corrida: lo justo para que el panel decida si
+ * vuelve a pedir lo que enseña.
+ */
+export interface AvisoDeCorrida {
+    correlationId: string;
+    /** De qué nodo salió. La lista de workflows agrupa por él. */
+    sourceId?: string;
+    /**
+     * `running` mientras graba pasos; el veredicto al cerrarse. Ojo: una
+     * corrida cerrada puede volver a `running` si llega un paso tarde (ver el
+     * grabador), así que el panel no debe tratar el cierre como definitivo.
+     */
+    status: 'running' | 'success' | 'failed' | 'partial';
+    /** `true` sólo en el aviso que manda el cierre. */
+    cerrada: boolean;
+}
 /** Un aviso en vivo al panel de la organización. */
 export interface AvisosEnVivo {
     emitNewEvent(webhookId: string, orgId: string, evento: object): void;
@@ -96,6 +113,20 @@ export interface AvisosEnVivo {
         pendingApproval: object;
     }): void;
     emitSwRunComplete(orgId: string, swId: string, run: object): void;
+    /**
+     * Una corrida del historial cambió: grabó un paso o se cerró [2026-09-29].
+     *
+     * Es lo que hace que Run History se mueva solo. Lo emiten LOS DOS que
+     * graban —el gateway y hw-nodes escriben en las mismas colecciones—, y por
+     * eso vive aquí y no en el grabador: el que graba en hw-nodes no tiene
+     * sockets, sólo este contrato.
+     *
+     * Es una SEÑAL, no el dato: quien escucha vuelve a pedir la lista o la
+     * corrida. Mandar la fila entera obligaría a leerla después de cada `$inc`,
+     * en el camino caliente de cada paso, para un panel que quizá nadie tiene
+     * abierto.
+     */
+    emitRunUpdate(orgId: string, corrida: AvisoDeCorrida): void;
     /**
      * Un contador de uso cambió. Sin payload: quien escucha vuelve a pedir
      * `GET /auth/me/usage`.
@@ -106,7 +137,7 @@ export interface AvisosEnVivo {
      *
      * No es difusión. Al otro lado hay un cliente esperando la respuesta de un
      * webhook en modo síncrono; perder este mensaje lo deja colgado hasta el
-     * 408 de `waitForSync`. Los otros nueve pueden ser «dispara y olvida»; éste
+     * 408 de `waitForSync`. Los demás pueden ser «dispara y olvida»; éste
      * necesita entrega, y por eso está escrito aparte y no mezclado arriba.
      */
     resolveSyncWaiter(eventId: string, resultado: {

package/dist/servicios/avisos-en-vivo.js

@@ -20,7 +20,7 @@
  *
  * ## Lo que ya estaba bien
  *
- * Los diez métodos reciben datos planos, y no por casualidad: los llamantes
+ * Los métodos reciben datos planos, y no por casualidad: los llamantes
  * ya hacen `.toJSON()` o pasan por `comoObjetoPlano(...)` antes de emitir.
  * Aquí no hay ningún documento de Mongoose que aplanar — algo que en la
  * costura de ficheros costó un adaptador entero.
@@ -37,9 +37,9 @@
  * clase que en `discord.provider` también se llama `gateway`. Medir por el
  * TIPO inyectado y no por el nombre de la propiedad es lo que los descarta.
  *
- * ## ⚠️ Nueve avisan, uno CONTESTA
+ * ## ⚠️ Todos avisan menos uno, que CONTESTA
  *
- * Nueve de los diez son difusión a la sala `org:<id>`: se mandan y no se
+ * Todos menos uno son difusión a la sala `org:<id>`: se mandan y no se
  * espera nada. Si se pierde uno, el panel enseña un dato viejo hasta que
  * alguien recargue — molesto y nada más.
  *
@@ -50,7 +50,7 @@
  *
  * Va en el mismo contrato porque hoy es la misma inyección y su único
  * llamante es el motor, pero quien implemente esto por red tiene que tratarlo
- * distinto: los nueve pueden ser «dispara y olvida», éste no.
+ * distinto: los demás pueden ser «dispara y olvida», éste no.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AVISOS_EN_VIVO = void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/platform-contracts",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Contratos compartidos entre los servicios de HostWebhook: addons del plan, identidad interna, y las formas que cruzan una frontera de red",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",