@hostwebhook/platform-contracts 0.14.0 → 0.15.0

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

@@ -59,16 +59,30 @@ export interface AvisosEnVivo {
     /** Un paso de pipeline terminó. */
     emitPipelineStep(orgId: string, paso: object): void;
     /**
-     * Un nodo FUENTE recibió algo.
+     * Un nodo acaba de persistir su salida.
      *
      * Evento propio y no `pipeline:step` porque un webhook recibiendo tráfico
      * no ejecuta un paso, y fabricarle uno falso ensucia a quien escucha pasos
      * de verdad.
+     *
+     * ## Las dos salidas van en campos distintos
+     *
+     * Un bucle emite DOS formas: por `loop` el elemento de la vuelta, por `done`
+     * lo acumulado de todas. El panel enseña cada una en su recuadro, así que
+     * meter la acumulación en `lastPayload` taparía una con la otra — el mismo
+     * fallo que ya costó separarlas en la base, donde compartían campo.
+     *
+     * Por eso `lastPayload` es opcional: el aviso del `done` no lleva ninguna, y
+     * quien lo recibe distingue las dos por qué campo vino relleno. Un aviso sin
+     * ninguno de los dos no dice nada y el receptor lo descarta.
      */
     emitNodePayload(orgId: string, data: {
         nodeType: string;
         nodeId: string;
-        lastPayload: unknown;
+        lastPayload?: unknown;
+        /** Lo que acumuló el puerto `done` de un bucle. Sólo lo llevan los
+         *  avisos del bucle; los demás nodos no tienen esa salida. */
+        donePayload?: unknown;
         /** Datos de ejemplo adoptados a mano; viaja aparte del payload. */
         example?: boolean;
     }): void;

package/dist/servicios/motor-de-ejecucion.d.ts

@@ -280,7 +280,25 @@ export interface CorridaDelMotor {
      * dure el flujo entero.
      */
     ejecutar(startNodeType: string, startNodeId: string, payload: Record<string, unknown> | undefined, orgId: string, userId: string, executionId: string): Promise<unknown>;
-    resumeFromApproval(approvalNode: NodoDeAprobacion, payload: Record<string, unknown>, action: 'approve' | 'reject', orgId: string): Promise<{
+    resumeFromApproval(approvalNode: NodoDeAprobacion, payload: Record<string, unknown>, action: 'approve' | 'reject', orgId: string, 
+    /**
+     * 🔴 La corrida que se está REANUDANDO, con el nombre que le puso la
+     * pendiente (`pipeline-test-<executionId>`).
+     *
+     * Sin ella, quien reanuda sorteaba un `executionId` nuevo, y eso rompía dos
+     * cosas que parecían fallos distintos:
+     *
+     *  · El modal de Run Pipeline filtra los pasos por el id de SU corrida, así
+     *    que descartaba TODOS los de la reanudación: se quedaba con el approval
+     *    en ámbar mientras el contador seguía corriendo.
+     *  · El historial agrupa por ese mismo id, así que los pasos se iban a otra
+     *    corrida y en la que se miraba salían en gris —«did not run»— incluida
+     *    la rama que sí se ejecutó.
+     *
+     * Opcional para que quien todavía no la pase siga compilando: sin ella se
+     * sortea como antes, que es peor pero es lo de siempre.
+     */
+    corridaQueSeReanuda?: string): Promise<{
         executionId: string;
         steps: PasoDeCorrida[];
     }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/platform-contracts",
-  "version": "0.14.0",
+  "version": "0.15.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",